Comprobantes fiscales (CFDI)
Una factura electrónica mexicana timbrada de ventas, notas de crédito, nómina, pagos o traslados.
- Nombre API:
fiscalmxcfdis - Dominio: FiscalMX
- Módulos: Finanzas, Recursos humanos
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| UUID | uuid | Texto | ||
| Cliente | customerId | Referencia | ||
| Registro | tableUid | Constante | Tabla de negocio a la que apunta esta fila. | |
| ID del registro | recordId | Texto | ||
| Inicio del periodo global | dateGlobalStart | Fecha | Fecha calendario de este valor. | |
| Fin del periodo global | dateGlobalEnd | Fecha | Fecha calendario de este valor. | |
| Periodicidad | periodicity | Constante | Opción fija del conjunto permitido para este campo. | |
| Origen | source | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Dirección | direction | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Versión | version | Texto | Número entero sin parte fraccionaria. | |
| Serie | serie | Texto | ||
| Folio | folio | Texto | ||
| Fecha de expedición | fecha | Fecha y Hora | ||
| Sello digital | sello | Texto | ||
| Número de certificado | noCertificado | Texto | ||
| Certificado | certificado | Texto | ||
| Forma de pago | formaPago | Texto | ||
| Condiciones de pago | condicionesDePago | Texto | ||
| Moneda | moneda | Texto | ||
| Tipo de cambio | tipoCambio | Texto | ||
| Tipo de comprobante | tipoDeComprobante | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Propósito | purpose | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Exportación | exportacion | Texto | ||
| Método de pago | metodoPago | Texto | ||
| Lugar de expedición | lugarExpedicion | Texto | ||
| Confirmación | confirmacion | Texto | ||
| RFC del emisor | emisorRfc | Texto | ||
| Nombre del emisor | emisorNombre | Texto | ||
| Régimen fiscal del emisor | emisorRegimenFiscal | Texto | ||
| Facilidad del emisor | emisorFacAtrAdquirente | Texto | ||
| RFC del receptor | receptorRfc | Texto | ||
| Nombre del receptor | receptorNombre | Texto | ||
| Domicilio fiscal del receptor | receptorDomicilioFiscal | Texto | ||
| Régimen fiscal del receptor | receptorRegimenFiscal | Texto | ||
| Uso del CFDI | receptorUsoCfdi | Texto | ||
| Residencia fiscal del receptor | receptorResidenciaFiscal | Texto | ||
| ID fiscal extranjero | receptorNumRegIdTrib | Texto | ||
| Periodicidad global | informacionGlobalPeriodicidad | Texto | ||
| Meses globales | informacionGlobalMeses | Texto | ||
| Año global | informacionGlobalAno | Texto | ||
| Ambiente del PAC | environment | Constante | Ambiente en el que se timbró. Los CFDI de pruebas no tienen validez fiscal. | |
| Versión del timbre | timbreVersion | Texto | ||
| Fecha de timbrado | timbreFechaTimbrado | Fecha y Hora | ||
| RFC del PAC | timbreRfcProvCertif | Texto | ||
| Leyenda del timbre | timbreLeyenda | Texto | ||
| Sello del CFDI | timbreSelloCfd | Texto | ||
| Número de certificado del SAT | timbreNoCertificadoSat | Texto | ||
| Sello del SAT | timbreSelloSat | Texto | ||
| XML | xml | |||
| Acuse de cancelación | cancellationAcuse | |||
| Estatus de cancelación | statusCancellation | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Estatus SAT | statusSat | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Modo de reconocimiento | recognitionMode | Texto | ||
| Tabla anfitriona | recognitionHostTableUid | Texto | ||
| REP vencido | isRepOverdue | Binario | Sí | Si está activo, la condición indicada aplica a este registro. |
| Timbrado vencido | isStampOverdue | Binario | Sí | Si está activo, la condición indicada aplica a este registro. |
| UUID de sustitución | cancellationReplacementUuid | Texto | ||
| Descuento | descuento | Moneda | Importe en la moneda del documento o de la partida. | |
| Impuestos retenidos | totalImpuestosRetenidos | Moneda | Importe monetario en la moneda que corresponde a este registro. | |
| Impuestos trasladados | totalImpuestosTrasladados | Moneda | Importe en la moneda del documento o de la partida. | |
| Emitir complemento antes de | datePagoDue | Fecha | Fecha de calendario sin hora. | |
| CFDI que sustituye | fiscalmxcfdiIdReplaces | Referencia | ||
| Subtotal | subtotal | Moneda | Suma de importes de partida antes de impuestos y retenciones en este documento. | |
| Total | total | Moneda | Total del documento tras descuentos, impuestos y retenciones en moneda del documento. | |
| Estatus | status | Constante | Sí | Estado del ciclo o del proceso según los valores permitidos para este registro. |
| Motivo de cancelación | cancelRequestReason | Constante | Opción fija del conjunto permitido para este campo. | |
| Reconocimiento el | recognitionAt | Fecha y Hora | ||
| Reconocido por | recognitionBy | Referencia | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Timbrado por | stampedBy | Usuario | ||
| Timbrado | stampedAt | Fecha y Hora | ||
| Cancelado por | canceledBy | Usuario | ||
| Cancelado el | canceledAt | Fecha y Hora | ||
| Cancelado ante el SAT por | canceledSatBy | Usuario | ||
| Cancelado ante el SAT | canceledSatAt | Fecha y Hora | ||
| Solicitada por | cancellationRequestedBy | Usuario | ||
| Cancelación solicitada | cancellationRequestedAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Cliente customerId | Clientes | referencia |
CFDI que sustituye fiscalmxcfdiIdReplaces | Comprobantes fiscales (CFDI) | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook fiscalmxcfdis.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Editar | update | Guarda los cambios del cfdi. | App · WebMCP · API · MCP · CLI |
| Cancelar | cancel | Revierte el efecto registrado de la acción. | App · WebMCP · API · MCP · CLI |
| Revocar enlaces externos | revoke | Revocar los enlaces externos activos del cfdi. | App · API · MCP · CLI |
| Cerrar periodo global | closeGlobalPeriod | Cerrar el periodo global del CFDI. | App · API · MCP · CLI |
| Reconocer | recognize | Vincular o borrador comercial desde CFDI importado. No contabiliza. | App · API · MCP · CLI |
| Solicitar cancelación | requestCancellation | Solicitar la cancelación de este CFDI timbrado. | App · API · MCP · CLI |
| Volver a timbrar | reseal | Actualizar la Fecha del CFDI y reconstruir el XML antes del timbrado. | App · API · MCP · CLI |
| Compartir externamente | share | Publicar y enviar un enlace externo a este documento. | App · API · MCP · CLI |
| Timbrar | stamp | Encolar este CFDI para timbrado PAC. | App · API · CLI |
| Sustituir | substitute | Crea un CFDI que sustituye a este (relación 04) para cancelarlo después con motivo 01. | App · API · CLI |
| Bloquear | block | Impide editar y eliminar el cfdi. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · WebMCP · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el cfdi. | App · WebMCP · API · MCP · CLI |
| Archivar | archive | Retira el cfdi del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívalo para restaurarlo. | App · WebMCP · API · MCP · CLI |
| Restaurar | unarchive | Devuelve el cfdi a las listas y las acciones activas. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.
| Acción | Nombre API |
|---|---|
| Cancelar | cancel |
| Solicitar cancelación | requestCancellation |