#Conceptos del dominio
La API usa vocabulario fiscal mexicano tal cual. Este glosario define cada término como aparece en las respuestas. Es informativo: Clarisfy no da consejo fiscal.
#SAT
Servicio de Administración Tributaria, la autoridad fiscal de México. Es la fuente de todos los datos que expone Clarisfy.
#CIEC
Clave de Identificación Electrónica Confidencial: la credencial del contribuyente para el portal del SAT. Clarisfy la usa para conectarse en nombre del contribuyente.
#RFC
Registro Federal de Contribuyentes: el identificador fiscal. Personas físicas (13 caracteres) y personas morales (12 caracteres). Es el identificador de negocio de una FiscalEntity.
#FiscalEntity
La representación en Clarisfy de un RFC con sus datos fiscales. Es la unidad de procesamiento y de cobro. Un Account (tu organización) puede administrar múltiples FiscalEntity.
#CFDI
Comprobante Fiscal Digital por Internet, la factura electrónica. Tiene versiones (3.3 y 4.0) y tipos:
| Tipo | Clave | Descripción |
|---|---|---|
| Ingreso | I | Factura de venta / cobro. |
| Egreso | E | Nota de crédito, devolución o descuento. |
| Nómina | N | Recibo de nómina. |
| Pago | P | Complemento de pago (REP). |
| Traslado | T | Movimiento de mercancía sin implicación de cobro. |
#CSF
Constancia de Situación Fiscal: el PDF oficial del SAT con el estado y el régimen del contribuyente.
#Opinión de Cumplimiento (32-D)
Documento del SAT que indica si el contribuyente está al corriente. Estados posibles: Positiva, Negativa, Inscrito sin obligaciones, No inscrito.
#Régimen fiscal
El esquema bajo el que tributa el contribuyente (por ejemplo RESICO, General de Ley, Sueldos y Salarios, Plataformas Tecnológicas). Determina obligaciones y cálculos.
#Buzón Tributario
El canal oficial del SAT para comunicarse con el contribuyente. Clarisfy expone sus dos tipos de mensajes:
- Notificaciones — actos administrativos con efectos legales (requerimientos, resoluciones).
- Comunicados — mensajes informativos sin efecto legal directo.
Consulta ambos en la Referencia de Buzón Tributario.