Introducción

A continuación encontrarás la documentación completa para poder consumir el API de Enlace Fiscal. Nuestro API se especializa en la generación y timbrado de Comprobantes Fiscales Digitales por Internet (CFDi), el tipo de comprobante fiscal más conocido es la Factura Electrónica pero se puede emitir cualquier tipo de comprobante incluyendo Recibos de Donativos y Nómina Electrónica. Nuestro API ya soporta la versión 3.3 del SAT que entró en vigor el 1 de Julio de 2017.

Endpoints

Los endpoints o funciones disponibles en nuestro API son los siguientes:

Generales

• Probar conexión
• Obtener saldo disponible en su cuenta

CFDi Comerciales

• Timbrado de CFDi 4.0
• Generar Recibo Electrónico de Pago (Complemento para Recepción de Pagos) 2.0
• Cancelar CFDi
• Obtener información de un CFDi previamente generado
• Obtener listado de comprobantes emitidos
• Enviar por correo un comprobante previamente generado

 Nómina

• Timbrado de comprobante de nómina asalariado
• Timbrado de comprobante de nómina asimilable

 Configuración para Diseños de PDF

• Alta de Nuevo Diseño de PDF
• Eliminar Diseño de PDF
• Listado de Diseños de PDF

Autenticación

# Realizar la petición desde shell es muy sencillo utilizando CURL  

curl "https://api.enlacefiscal.com/v6/probarConexion" 
  --request "POST" 
  --header "Content-Type:application/json"
  --header "x-api-key:e9aT1ajrRh1NyRkzOtDoN1ZEGmIsEKuJ6f3FYyLh"
  --user "AAA010101AAA:7aa16d2e055554fcf3d182758db23c91"
  --data '{"Solicitud" : {"modo" : "produccion", "rfc" : "AAA010101AAA", "accion": "probarConexion" } }'

Nuestro API utiliza autenticación vía headers de HTTP. Cada petición a nuestro API deben ser enviada con un usuario, un token y un API Key para que pueda ser autenticada.

Probar Conexión

Probar Conexión

curl "https://api.enlacefiscal.com/v6/probarConexion" 
  --request "POST" 
  --header "Content-Type:application/json"
  --header "x-api-key:e9aT1ajrRh1NyRkzOtDoN1ZEGmIsEKuJ6f3FYyLh"
  --user "AAA010101AAA:7aa16d2e055554fcf3d182758db23c91"
  --data '{"Solicitud" : { "rfc" : "AAA010101AAA", "accion": "probarConexion" } }'

<?php

$aAuth = array('User' => 'AAA010101AAA',
               'Pass' => '7aa16d2e055554fcf3d182758db23c91');

$sUrl = "https://api.enlacefiscal.com/v6/probarConexion";

$aData = array();

$aData = array('Solicitud' => array('rfc'  => 'AAA010101AAA',
                                    'accion' => 'probarConexion'));

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $sUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");

$sDataJson =  json_encode($aData);

curl_setopt($ch, CURLOPT_POSTFIELDS, $sDataJson);

$nContentLenght = strlen($sDataJson);

curl_setopt($ch, CURLOPT_HEADER, 0);

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'x-api-key: ' . $aAuth['Pass'],
    'Content-Length: ' . $nContentLenght
));

curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "{$aAuth['User']}:{$aAuth['Pass']}");

$sOutput = curl_exec($ch);
curl_close($ch);

echo $sOutput;
?>

Probar Conexión - Request:

{
    "Solicitud": {
        "rfc": "AAA010101AAA",
        "accion": "probarConexion"
    }   
}

Probar Conexión - Response:

{
    "AckEnlaceFiscal": {
        "numeroReferencia": 1,
        "estatusDocumento": "aceptado",
        "fechaMensaje": "2017-08-25 23:04:40",
        "version": "1.0"
    }
}

El servicio más sencillo para consumir es el de prueba de conexión, es por eso que la recomendación es empezar a consumir primero éste servicio para asegurarnos que la conexión es exitosa y que los datos de autenticación son los correctos.

API Endpoint
POST https://api.enlacefiscal.com/v6/probarConexion

rfc Es el RFC de la cuenta que está consumiendo el API, se utiliza como elemento adicional de autenticación. No debe contener guiones ni espacios.

accion Campo que nos permite indicar el método que queremos consumir vía el API.

Obtener Saldo

Obtener Saldo

curl "https://api.enlacefiscal.com/v6/obtenerSaldo" 
  --request "POST" 
  --header "Content-Type:application/json"
  --header "x-api-key:e9aT1ajrRh1NyRkzOtDoN1ZEGmIsEKuJ6f3FYyLh"
  --user "AAA010101AAA:7aa16d2e055554fcf3d182758db23c91"
  --data '{"Solicitud" : {"rfc" : "AAA010101AAA", "modo" : "produccion"} }'

Obtener Saldo - Request:

{
    "Solicitud" : {
        "rfc" : "AAA010101AAA", 
        "accion": "obtenerSaldo"
    } 
}

Obtener Saldo - Response:

{
    "AckEnlaceFiscal": {
        "numeroReferencia": "622",
        "estatusDocumento": "aceptado",
        "fechaMensaje": "2017-08-16 13:51:03",
        "version": "1.0",
        "saldo": "9689.01",
        "fechaUltimoAbono": "2017-08-16",
        "montoUltimoAbono": "0.00"
    }
}

Enlace Fiscal funciona en un esquema de prepago y es necesario tener saldo disponible para poder utilizar nuestros servicios. Puedes utilizar ésta función para consultar tu saldo disponible.

API Endpoint
POST https://api.enlacefiscal.com/v6/obtenerSaldo

rfc Es el RFC de la cuenta que está consumiendo el API, se utiliza como elemento adicional de autenticación. No debe contener guiones ni espacios.

accion Campo que nos permite indicar el método que queremos consumir vía el API.

Cambios de CFDi 3.3 a 4.0

A continuación encontrarás la nueva documentación de cambiós de CFDi 3.3 a 4.0.

Información General CFDi 4.0

versionCFDi El valor de este campo se cambia de 3.3 a 4.0.

Ir a documentación de versión CFDi

versionEF El valor de este campo se cambia de 6.0 a 6.5.

Ir a documentación de versión EF

facAtrAdquirente Nuevo atributo para la versión 4.0.

Ir a documentación de factura adquirente

exportacion Nuevo atributo para la versión 4.0.

Ir a documentación de exportación

Información Global CFDi 4.0

Esta sección es un nuevo nodo condicional dentro del json CFDi 4.0

periodicidad Nuevo atributo para la versión 4.0 y debe contener un valor del catálogo c_Periodicidad del SAT.

Ir a documentación de periodicidad

meses Nuevo atributo para la versión 4.0 y debe contener un valor del catálogo c_Meses del SAT.

Ir a documentación de meses

anio Nuevo atributo para la versión 4.0 en el cual se expresa el año al que corresponde la información del comprobante global.

Ir a documentación de anio

Comprobantes Relacionados CFDi 4.0

ComprobantesRelacionados Esta sección del json se modifica aceptando múltiples nodos, lo que anteriormente solo se podía uno.

Ir a documentación de comprobantes relacionados

Receptor CFDi 4.0

nombre Este campo cambió de ser opcional de la versión 3.3a ser obligatorio en la version 4.0.

Ir a documentación de nombre

Receptor / Partes / DomicilioFiscal / cp Este campo cambió de ser opcional de la versión 3.3a ser obligatorio en la version 4.0 mientras que los demás campos del nodo DomicilioFiscal quedaron opcionales.

Ir a documentación de cp

regimenFiscal Este atributo es nuevo para la versión 4.0 y debe contener un valor del catálogo c_RegimenFiscal del SAT el cual debe corresponder con el tipo de persona del receptor.

Ir a documentación de régimen fiscal

Partidas CFDi 4.0

objetoDeImpuesto Este atributo es nuevo para la versión 4.0 y debe contener un valor del catálogo c_ObjetoImp del SAT.

Ir a documentación de objeto de impuesto

Partidas / Impuestos Este nodo se vuelve condicional, cuando el tipo de comprobante sea "T" o "P", este elemento no debe existir.

Ir a documentación de impuestos

Partidas / ACuentaTerceros Este es un nuevo nodo dentro de la sección partidas para la versión 4.0 el cual es opcional para expresar información del contribuyente Tercero.

Ir a documentación a cuenta terceros

rfc Nuevo atributo para la versión 4.0 y debe contener un RFC valido dentro del LCO.

Ir a documentación de rfc

nombre Nuevo atributo para la versión 4.0, este atributo deber ser diferente al valor registrado en los campos RFC de los nodos Emisor y Receptor.

Ir a documentación de nombre

regimenFiscal Nuevo atributo para la versión 4.0 y debe contener un valor del catálogo c_RegimenFiscal del SAT.

Ir a documentación de regimen fiscal

cp Nuevo atributo para la versión 4.0 y debe pertenecer al nombre asociado al RFC registrado en el atributo rfc de este nodo.

Ir a documentación de cp

Partidas / CuentaPredial El campo numeroCuentaPredial de CFDi 3.3 cambió de ser atributo a ser un nodo opcional para la versión 4.0 al cual se le pueden agregar multiples numero de predial.

Ir a documentación a cuenta predial

numero Nuevo atributo para la versión 4.0 y debe pertenecer al nombre asociado al RFC registrado en el atributo rfc de este nodo.

Ir a documentación de número

Partidas / InformacionAduanera
numeroPedimentoEste campo cambió de ser atributo a ser un nodo donde puede llevar multiples numero de pedimentos.

Ir a documentación de número

Partidas / Partes / InformacionAduanera
numeroPedimento Este campo cambió de ser atributo a ser un nodo donde puede llevar multiples numero de pedimentos.

Ir a documentación de número

Impuestos del Comprobante CFDi 4.0

Impuestos / Impuestos
baseImpuesto Nuevo atributo para la versión 4.0 para registrar el monto de la base del impuesto.

Ir a documentación de base impuesto

Timbrado CFDi 4.0

A continuación encontrarás la documentación completa de todos los elementos que componen la petición de generación y timbrado de un comprobante fiscal digital (CFDi versión 4.0).

Requisitos:

• Es necesario contar con la Modalidad API activa en tu cuenta.
• Contar con un token de autenticación.
• Tener Series de Folios para la modalidad API en el módulo de Datos Fiscales.
• Tener un Certificado de Sello Digital (CSD) configurado en tu cuenta.

Si ya consumes nuestro API para timbrar CFDi 3.3, consulta nuestra guía de cambios 3.3 -> 4.0 para identificar más rápido los cambios necesarios.

Información General 4.0

Este servicio (RESTful API), permite generar y timbrar un comprobante fiscal digital en el esquema CFDi 4.0. Algunos de los elementos son opcionales y permiten una mayor personalización del CFDi versión 4.0.

Generar CFDi - Request:

{
    "CFDi": {
        "versionCFDi": "4.0",
        "modo": "debug",
        "versionEF": "6.5",
        "serie": "FA",
        "folioInterno": "1",
        "fechaEmision": "2022-02-01 11:22:01",
        "subTotal": "1500.00",
        "descuentos": "50.00",
        "total": "1587.00",
        "tipoMoneda": "MXN",
        "nombreDisenio": "Diseño Compacto",
        "rfc": "AAA010101AAA",
        "facAtrAdquirente": "012345678",
        "exportacion": "01",
        ...

API Endpoint
POST https://api.enlacefiscal.com/v6/generarCfdi

CFDi Encabezado del Comprobante

versionCFDi Versión del CFDi a timbrar en el SAT

modo Es la modalidad del API en la que se va a generar el comprobante fiscal digital, siendo las opciones posibles: debug o produccion.

• Cuando nos encontramos realizando la implementación inicial del API es muy útil poder realizar pruebas de generación de comprobantes "sin efectos fiscales" para asegurarnos de que todo funciona correctamente.
• Al utilizar el valor debug se generan comprobantes de prueba "sin valor fiscal" permitiendo verificar que todos los demás elementos del comprobante sean correctos, como si fuese uno real (diseño del comprobante, envío de correo, configuración de impuestos, etc).

versionEF Versión del API de Enlace Fiscal

serie Es la serie de folios que se asignará al comprobante fiscal digital para poder identificarlo de una manera sencilla. Se utiliza para control interno.

folioInterno Se utiliza para identificar el comprobante fiscal digital generado, es para control interno.

El folio interno junto con la serie asignada se utilizan como método de control para evitar timbrar un mismo comprobante más de una vez. Si por error se llega a enviar la petición de timbrado de un mismo folio y serie en varias ocasiones, nuestro API no la timbra otra vez, simplemente se envía la información del timbrado original.

fechaEmision Fecha de emisión del comprobante fiscal digital, debe corresponder con la hora local donde se expide el comprobante. El tiempo máximo que se tiene entre la fecha de emisión y la petición de timbrado es de 72 horas por disposición oficial.

subTotal Es la suma de los importes antes de descuentos e impuestos, no se permiten valores negativos.

• Debe tener la cantidad de decimales que soporte la moneda.

descuentos Es el importe total de los descuentos aplicables antes de impuestos, no permite valores negativos.

• Debe de tener hasta la cantidad de decimales que soporte la moneda.
• El valor debe de ser menor o igual que el subtotal.
• Debe registrarse éste campo cuando al menos una de las partidas tenga descuento. En caso de que no se apliquen descuentos, éste campo no debe existir.
• Debe ser igual a la suma de los campos descuento de cada una de las partidas, redondeado al número de decimales que soporta la moneda utilizada.

total Es la suma del subtotal, menos los descuentos aplicables, más las contribuciones recibidas, menos los impuestos retenidos (federales y/o locales). No se permiten valores negativos.

• Debe de tener la misma cantidad de decimales que soporte la moneda.
• Cuando el tipo de comprobante sea de tipo Traslado (Carta Porte) éste campo debe ser igual a cero.

tipoMoneda Es la clave de la moneda utilizada conforme al catálogo publicado por el SAT.

tipoCambio Tipo de cambio conforme a la moneda utilizada. Es requerido cuando la moneda es distinta a Peso Mexicano (MXN) y a la clave (XXX).

nombreDisenio Nombre del diseño que se utilizará para generar el PDF del comprobante fiscal.

• El diseño a utilizar y el nombre asignado se pueden consultar en el portal web de Enlace Fiscal.
• En caso de no especificarse se utilizará el diseño predeterminado del portal web de su cuenta de Enlace Fiscal.

rfc Registro Federal de Contribuyentes correspondiente al emisor del comprobante fiscal digital. No debe contener guiones ni espacios.

El RFC que se utilice deberá estar en la lista de RFC inscritos no cancelados en el SAT (l_rfc).

facAtrAdquirente Campo condicional para registrar el número de operación proporcionado por el SAT, el cual consta de 10 dígitos, cuando se trate de un comprobante a través del adquirente de los productos o servicios siempre que la respuesta del servicio sea en sentido positivo, conforme a la Resolución Miscelánea Fiscal vigente.

exportacion Campo requerido para registrar la clave con la que se identifica si el comprobante ampara una operación de exportación, las distintas claves vigentes se encuentran incluidas en el catálogo c_Exportacion del SAT

• Cuando se registre el valor "02", se debe incluir el Complemento para Comercio Exterior

Datos de Pago 4.0

En esta sección se incluye la información sobre el pago del comprobante fiscal digital emitido. Esta sección es requerida en la petición a excepción de que la serie sea de tipo Comprobante de traslado.

Datos de Pago [requerido] :

{
    "CFDi": {
        ...,
        "DatosDePago": {
            "metodoDePago": "PUE", 
            "formaDePago": "03",
            "condicionesDePago": "45 días",
            "fechaVencimiento": "2022-02-23",
            "referenciaBancaria": "3444232132"
        },
        ...,

metodoDePago Elemento para especificar la Clave que corresponda al método de pago utilizado.

formaDePago Dato para expresar la Clave o Clave Texto que corresponda a la forma de pago utilizada para el pago de los bienes, servicios o la forma en que se recibe el donativo.

• En el caso en el que se utilice más de una forma de pago , se debe señalar con la que se liquida la mayor cantidad del pago. Cuando se reciban distintas formas de pago con el mismo importe, se debe registrar una de ellas a consideración del usuario.
• En caso de que no se reciba el pago de la operación en el momento de la emisión del comprobante (PPD), se debe seleccionar la clave 99 (Por definir).
• Este campo debe contener la clave 99 cuando el campo metodoDePago contenga el valor "PPD".

condicionesDePago Se pueden registrar las condiciones comerciales aplicables para el pago del comprobante fiscal, cuando existan éstas y cuando el tipo de comprobante sea Ingreso o Egreso.

• En este campo se podrán registrar de 1 hasta 1000 caracteres.

fechaVencimiento De manera opcional se puede registrar la fecha en la que se vence el pago de un comprobante para un control interno.

• Esta campo es informativo y se recomienda capturar la fecha cuando el método de pago es PPD.

referenciaBancaria Dato opcional para incorporar al menos los cuatro últimos dígitos del número de cuenta con la que se realizó el pago.

• En caso de haber utilizado un valor en el nodo formaDePago que no requiera especificar un dato numérico (ejemplo: Efectivo) se debe omitir éste nodo por completo.

Información Global 4.0

En este nodo se puede expresar la información relacionada con el comprobante global de operaciones con el público en general.

Información Global [condicional] :

{
    "CFDi": {
        ...,
        "InformacionGlobal": {
            "periodicidad": "04",
            "meses": "01",
            "anio": "2022"
        },
        ...,

InformacionGlobal Sección condicional para indicar la información relacionada con el comprobante global de operaciones con el público en general.

periodicidad Campo requerido para registrar el período al que corresponde la información del comprobante global, las distintas claves vigentes se encuentran incluidas en el catálogo c_Periodicidad del SAT.

• Cuando el valor de este campo sea "05" el campo RegimenFiscal debe ser "621".

meses Campo requerido para registrar la clave del mes o los meses al que corresponde la información de las operaciones celebradas con el público en general, las distintas claves vigentes se encuentran incluidas en el catálogo c_Meses del SAT.

• Cuando el valor del campo periodicidad sea "05", este campo debe contener alguno de los valores "13", "14", "15", "16", "17" o "18"
• Si el campo periodicidad contiene un valor diferente de "05", este campo debe contener alguno de los valores "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11" o "12".

anio Campo requerido para registrar el año al que corresponde la información del comprobante global.

• El valor registrado debe ser igual al año en curso o hasta 5 ejercicios anteriores.

Comprobantes Relacionados 4.0

En esta sección se incluirá la información de los comprobantes fiscales relacionados con el que se está generando.

Comprobantes Relacionados [condicional]:

{
    "CFDi": {
        ...,
        "ComprobantesRelacionados": [{
            "tipoRelacion": "nota_credito",
            "Comprobantes": [
                    "eeca15af-e9b1-4a45-9861-8d51c4fa8219",
                    "FA-250"
            ]
        }, {
            "tipoRelacion": "02",
            "Comprobantes": [
                    "eefv15af-e9b1-4r45-7577-8d51c4fa6535"
            ]
        }],
        ...,

ComprobantesRelacionados Sección opcional para indicar la información de los distintos comprobantes fiscales relacionados.

tipoRelacion Tipo de relación que existe entre el comprobante que se está generando y los generados previamente.

• Si el comprobante generado es una Nota de Crédito, en éste campo se señala el comprobante tipo "I" (Ingreso) al que se relaciona ésta Nota de Crédito.
• En el caso de que el comprobante generado sea de tipo "T" (Traslado), en éste campo se indica el comprobante de tipo "I" (Ingreso) o "E" (Egreso) relacionados a éste comprobante.

Para obtener más información acerca del tipo de relación que lleva este documento favor de entrar en la sección de catálogo de tipos relación.

Comprobantes Es un arreglo con la información de los comprobantes relacionados.

• Sólo se puede utilizar la opción de Serie-Folio cuando el comprobante a relacionar se haya emitido también en Enlace Fiscal. En caso contrario, se debe utilizar el UUID.

Receptor 4.0

Esta sección contiene los datos correspondientes al receptor del comprobante fiscal.

Receptor [requerido]

{
    "CFDi": {
        ...,
        "Receptor": {
            "rfc": "AAA010101AAA",
            "nombre": "EMPRESA DEMO",
            "residenciaFiscal": "USA",
            "numeroRegistroIdTributario": "121585958",
            "regimenFiscal": "601",
            "usoCfdi": "adquisicion_mercancias",
            "IdentificadorCliente": {
                "nombreCampo": "Número de Matrícula",
                "valorCampo": "A12332"
            },
            "DomicilioFiscal": {
                "calle": "Rayo",
                "noExterior": "2835",
                "noInterior": "1-A",
                "colonia": "Jardines del norte",
                "localidad": "Guadalajara",
                "municipio": "Guadalajara",
                "estado": "Jalisco",
                "pais": "México",
                "cp": "44580"
            }
        },
       ...,

rfc Registro Federal de Contribuyentes correspondiente al receptor del comprobante, debe ir sin guiones ni espacios.

• Si el RFC es genérico (XAXX010101000, XEXX010101000) el nodo DomicilioFiscal del receptor es opcional.
• El RFC que se utilice deberá estar en la lista de RFC inscritos no cancelados en el SAT _(l_rfc)_.

nombre Campo requerido, es el nombre fiscal del receptor (cliente) y se debe registrar en MAYÚSCULAS de la siguiente manera:

• Tratándose de persona física: En mayúsculas el nombre, primer apellido y segundo apellido.
• Tratándose de persona moral: En mayúsculas denominación o razón social registrados en el RFC.

Debe registrarse tal y como se encuentra en la Cédula de Identificación Fiscal y Constancia de Situación Fiscal, respetando números, espacios y signos de puntuación.

• Genera tu Constancia de Situación Fiscal
• Obtén tu cédula de identificación fiscal

residenciaFiscal Es el país de residencia fiscal del receptor (cliente) del comprobante, éste dato es requerido si se incluye el Complemento de Comercio Exterior o si se agrega en Número de Registro de Identidad Tributario.

numeroRegistroIdTributario Es el número de registro de identidad fiscal del receptor cuando sea residente en el extranjero. Es requerido cuando se incluya el Complemento de Comercio Exterior.

regimenFiscal Campo requerido para registrar la clave vigente del régimen fiscal del contribuyente receptor, las distintas claves vigentes se encuentran incluidas en el catálogo c_RegimenFiscal del SAT.

• Si el contribuyente receptor es genérico (XEXX010101000, XAXX010101000) se debe registrar la clave "616" Sin obligaciones fiscales.

usoCfdi Es la clave o descripción del uso que dará a esta factura el receptor del CFDi.

• En el caso de que se emita un CFDI a un residente en el extranjero con RFC genérico XEXX010101000, en este campo se debe registrar la clave "S01" (sin_efectos_fiscales).
• El valor que registre en este atributo debe aplicar para el tipo de persona del receptor y el régimen correspondiente, es decir, si el RFC tiene longitud de 12 posiciones, debe ser de persona moral y si tiene longitud de 13 posiciones debe ser de persona física

Receptor / IdentificadorCliente [opcional]

{
    "CFDi": {
    ...

        ...
        "Receptor": {
            ...

            "IdentificadorCliente": {
                "nombreCampo": "Número de Matrícula",
                "valorCampo": "A12332"
            },

            ...

        },
       ...

IdentificadorCliente

Es un arreglo opcional para agregar un identificador personalizado del receptor. La información del identificador únicamente aparece en la versión PDF del comprobante fiscal en la sección de datos del receptor.

• Por ejemplo, la Escuela ABC emite facturas a sus alumnos por el pago de colegiatura, la escuela identifica a sus alumnos por número de matrícula y desea que este dato se muestre en la versión impresa del comprobante fiscal.

nombreCampo Elemento que especifica el nombre del identificador que se usará.

valorCampo Es el valor del identificador del receptor.

Receptor / DomicilioFiscal [requerido]

{
    "CFDi": {
    ...

        ...
        "Receptor": {
            ...
            "IdentificadorCliente": {
                ...
            },
            "DomicilioFiscal": {
                "calle": "Rayo",
                "noExterior": "2835",
                "noInterior": "1-A",
                "colonia": "Jardines del norte",
                "localidad": "Guadalajara",
                "municipio": "Guadalajara",
                "estado": "Jalisco",
                "pais": "México",
                "cp": "44580"
            }
        },
       ...

DomicilioFiscal Sección requerida para agregar la dirección del receptor del comprobante. Ésta información únicamente aparece en la versión PDF del comprobante fiscal.

calle Elemento que indica el nombre de la vialidad del domicilio fiscal del receptor.

noExterior Elemento que contiene el valor del número exterior del domicilio fiscal del receptor.

noInterior Elemento que contiene el valor del número interior del domicilio fiscal del receptor.

colonia Elemento que contiene el nombre de la colonia o asentamiento del domicilio fiscal del receptor.

localidad Elemento que contiene el nombre de la localidad (poblado o ciudad) del domicilio fiscal del receptor.

municipio Elemento que contiene el nombre del municipio o delegación (en el caso de la Ciudad de México) del domicilio fiscal del receptor.

estado Elemento que indica el estado (o equivalente en caso de extranjeros) del domicilio fiscal del receptor.

pais Elemento que indica el país del domicilio fiscal del receptor.

cp Elemento que indica el código postal (o equivalente en caso de extranjeros) del domicilio fiscal del receptor.

Partidas del Comprobante 4.0

Bloque requerido que agrupa a todas las partidas del Comprobante Fiscal Digital (CFDi 4.0)

Partidas [requerido]

{
    "CFDi": {
        ...,
        "Partidas": [
            {
                "cantidad": "10",
                "claveUnidad": "E48",
                "unidad": "Unidad de servicio",
                "claveProdServ": "80101500",
                "noIdentificacion": "421412321212321",
                "descripcion": "Servicios de consultoría de negocios y administración corporativa",
                "valorUnitario": "100.00",
                "importe": "1000.00",
                "descuento": "50.00",
                "objetoDeImpuesto": "01",
                "Impuestos": [
                    {
                        "tipo": "traslado",
                        "claveImpuesto": "IVA",
                        "tipoFactor": "tasa",
                        "tasaOCuota": "0.16",
                        "baseImpuesto": "950.00",
                        "importe": "152.00"
                    },
                    {
                        "tipo": "retencion",
                        "claveImpuesto": "ISR",
                        "tipoFactor": "tasa",
                        "tasaOCuota": "0.10",
                        "baseImpuesto": "950.00",
                        "importe": "95.00"
                    }
                ],
                 "ACuentaTerceros": {
                    "rfc": "FIMA420127R44",
                    "nombre": "Marton Aleejandro Sanzi Fierror",
                    "regimenFiscal": "601",
                    "codigoPostal": "44580"
                },
                "CuentaPredial": {"numero": [
                    "49199",
                    "49199"
                ]},
                "InformacionAduanera": {"numeroPedimento": [
                    "15  48  3009  0001234",
                    "15  48  3009  0001234"
                ]},
            },
            {
                "cantidad": "1",
                "claveUnidad": "C62",
                "unidad": "Uno",
                "claveProdServ": "84101700",
                "noIdentificacion": "4214123212123212",
                "descripcion": "Manejo de deuda",
                "valorUnitario": "500.00",
                "importe": "500.00",
                "objetoDeImpuesto": "01",
                "Impuestos": [{
                    "tipo": "traslado",
                    "claveImpuesto": "IVA",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.16",
                    "baseImpuesto": "500.00",
                    "importe": "80.00"
                }],
                 "ACuentaTerceros": {
                    "rfc": "FIMA420127R44",
                    "nombre": "Marton Aleejandro Sanzi Fierror",
                    "regimenFiscal": "601",
                    "codigoPostal": "44580"
                },
                "CuentaPredial": {"numero": [
                    "49199",
                    "49199"
                ]},
                "InformacionAduanera": {"numeroPedimento": [
                    "15  48  3009  0001234",
                    "15  48  3009  0001234"
                ]},
            }
        ],
        ...,

Partidas

• Se pueden agregar hasta 200 partidas por comprobante.
• Se requiere al menos una partida por comprobante.

cantidad Es el número de articulos o servicios de la partida, puede tener hasta seis números decimales.

claveUnidad Es la clave de unidad de medida estandarizada conforme el cátalogo c_ClaveUnidad del SAT. La unidad debe corresponder con la descripción de la partida.

unidad Campo para indicar la unidad de medida propia de la operación del emisor. La unidad debe corresponder con el producto o servicio de la partida.

claveProdServ Clave que permite clasificar el producto o servicio que se indica en la partida. Se debe utilizar una de las claves del catálogo c_ClaveProdServ publicado por el SAT.

Te recomendamos utilizar la herramienta de cfdi.ninja para encontrar fácilmente la clave del producto o servicio en el catálogo del SAT _ClaveProdServ.

• En el caso de que la clave de un producto o servicio no se encuentre en el catálogo se debe registrar la clave "01010101".

noIdentificacion Es el código o clave de identificación de los bienes o servicios de la partida. Este dato también se conoce como "SKU".

descripcion Es la descripción del bien o servicio de la partida. En este campo se puede incluír cualquier tipo de información o texto que detalle de lo que se trata la partida.

valorUnitario Es el valor o precio unitario de los bienes o servicios de la partida.

• No se permiten valores negativos.
• La precisión con la que se indica éste dato deberá ser el indicado para la moneda utilizada.

importe Es el importe total de los bienes o servicios descritos en la partida.

• Debe de ser el equivalente al resultado de multiplicar la cantidad por el valor unitario de la partida sin considerar descuentos.
• No se permiten valores negativos.

objetoDeImpuesto Campo requerido para registrar la clave correspondiente para indicar si la operación comercial es objeto o no de impuesto, las distintas claves vigentes se encuentran incluidas en el catálogo c_ObjetoImp del SAT.

• Si el valor registrado en este campo es "02" (Sí objeto de impuesto) se deben desglosar los Impuestos a nivel de Concepto.
• Si el valor registrado en este campo es "01" (No objeto de impuesto), "03" (Sí objeto del impuesto y no obligado al desglose), "04" (Sí objeto del impuesto y no causa impuesto) o "05" (Sí objeto del impuesto, IVA crédito PODEBI) no se desglosan Impuestos a nivel Concepto.

descuento Es el importe de los descuentos aplicables a cada partida.

• Debe de tener el mismo número de decimales que el campo de importe.
• No se permiten valores negativos.
• Debe ser menor o igual al campo de importe.

Partidas / Impuestos [condicional]

{
    "CFDi": {
    ...

        ...
        "Partidas": [
            {
                ...
                "Impuestos": [
                    {
                        "tipo": "traslado",
                        "claveImpuesto": "IVA",
                        "tipoFactor": "tasa",
                        "tasaOCuota": "0.16",
                        "baseImpuesto": "950.00",
                        "importe": "152.00"
                    },
                ],
                ...

Partidas / Impuestos

Esta sección condicional contiene la información detallada de los impuestos federales retenidos y trasladados de la partida. Es requerido indicar los impuestos que aplican conforme al servicio o producto que se describe en la partida.

• Cuando el tipo de comprobante sea "T" o "P", este elemento no debe existir.

tipo Es el tipo de impuesto conforme a los disponibles en el catálogo c_Impuesto del SAT.

claveImpuesto Es la clave de impuesto de la partida conforme al catálogo c_Impuesto del SAT.

tipoFactor Es el tipo de factor que se aplica a la base del impuesto de la partida.

• Uno de los impuestos más comunes es el IVA con tasa del 16%, en éste caso el tipoFactor es tasa.

tasaOCuota Es el valor de la tasa o cuota que aplica para la partida. Éste campo es requerido cuando el campo tipoFactor sea tasa o cuota.

• Este campo No es requerido cuando el campo tipoFactor sea exento.

baseImpuesto Es el valor base para el cálculo del impuesto de la partida.

• El valor de éste campo debe de ser mayor a cero.

importe Es el importe del impuesto que aplica a la partida.

• Este campo No es requerido cuando el campo tipoFactor sea exento.
• Este campo es requerido cuando el campo tipoFactor se haya registrado como tasa o cuota.
• No se permiten valores negativos.

Partidas / ACuentaTerceros [opcional]

{
    "CFDi": {
    ...

        ...
        "Partidas": [
            {
                ...

                "ACuentaTerceros": {
                    "rfc": "FIMA420127R44",
                    "nombre": "Marton Aleejandro Sanzi Fierror",
                    "regimenFiscal": "601",
                    "cp": "44580"
                },
            },
            ...
        ],
        ...

Partidas / ACuentaTerceros Esta sección es opcional y se puede expresar información del contribuyente Tercero, a cuenta del que se realiza la operación. Conforme a la regla 2.7.1.3 de la Resolución Miscelánea Fiscal vigente.

rfc Campo requerido para registrar la Clave del Registro Federal de Contribuyentes del contribuyente Tercero, a cuenta del que se realiza la operación.

• La clave registrada en este campo debe ser diferente a la clave registrada en los campos RFC del Emisor y Receptor.

nombre Campo requerido para registrar el nombre, denominación o razón social del contribuyente Tercero correspondiente con el RFC, a cuenta del que se realiza la operación.

• En el caso de personas morales se debe adicionar el régimen societario.

regimenFiscal Campo requerido para registrar la clave del régimen del contribuyente Tercero, a cuenta del que se realiza la operación, las distintas claves vigentes se encuentran incluidas en el catálogo c_RegimenFiscal del SAT.

• En el caso de personas morales se debe adicionar el régimen societario.

cp Campo requerido para registrar el código postal del domicilio fiscal del Tercero, a cuenta del que se realiza la operación.

• El código postal, debe estar asociado a la clave de RFC registrado en el campo rfc de cuentas a terceros.

Partidas / CuentaPredial [opcional]

{
    "CFDi": {
    ...

        ...
        "Partidas": [
            {
                ...

                "CuentaPredial": {"numero": [
                    "49199",
                    "49199"
                ]},
            },
            ...
        ],
        ...

Partidas / CuentaPredial Esta sección opcional se puede expresar el número de cuenta predial con el que fue registrado el inmueble en el sistema catastral de la entidad federativa de que trate, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable

numero Es el número de cuenta predial con el que fue registrado el inmueble en el sistema catastral de la entidad federativa de que se trate o bien se pueden indicar los datos de identificación del certificado de participación inmobiliaria no amortizable.

• En este campo se podrán agregar multiples números de cuenta predial.

Partidas / InformacionAduanera [opcional]

{
    "CFDi": {
    ...

        ...
        "Partidas": [
            {
                ...

                "InformacionAduanera": {"numeroPedimento": [
                "15  48  3009  0001234",
                "15  48  3009  0001234"
            ]}
            },
            ...
        ],
        ...

Partidas / InformacionAduanera

Esta sección contiene la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas o se trate de operaciones de comercio exterior de bienes o servicios.

Es condicional porque solo se debe incluir si el producto que se está comercializando es de importación y no se incluye el Complemento de Comercio Exterior.

numeroPedimento Es el número de pedimiento correspondiente a la importación del bien, en este campo se podrán agregar multiples número de pedimento.

Las reglas de formación de éste dato (iniciando por la izquierda) son las siguientes:

Últimos dos dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado, iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana.

• Solo se incluye éste campo cuando el comprobante No incluya el complemento de comercio exterior.

Partidas / Partes [opcional]

{
    "CFDi": {
        ...

        "Partidas": [
            {


                ...

                "Partes": [
                    {
                        "cantidad": "10",
                        "claveProdServ": "27111731",
                        "unidad": "Pieza",
                        "noIdentificacion": "R-DSA2332",
                        "descripcion": "Desarmador",
                        "valorUnitario": "100.00",
                        "importe": "1000.00"
                    },
                    {
                        "cantidad": "5",
                        "claveProdServ": "27111750",
                        "unidad": "Pieza",
                        "noIdentificacion": "R-DSC2345",
                        "descripcion": "Pinzas",
                        "valorUnitario": "50.00",
                        "importe": "250.00",
                        "InformacionAduanera": {"numeroPedimento": [
                            "15  48  3009  0001234",
                            "15  48  3009  0001234"
                        ]},
                    }
                ]
            }
        ],
        ...

Partidas / Partes

En esta sección opcional se pueden expresar las partes o componentes que integrarán la totalidad del concepto expresado en la partida del CFDi.

cantidad Es el número de artículos o servicios correspondiente a la parte.

claveProdServ Es la clave del producto o servicio correspondiente a la parte. Se deben de utilizar las claves incluidas en el cátalogo C_ClaveProdServ publicado por el SAT.

Te recomendamos utilizar la herramienta de cfdi.ninja para encontrar fácilmente la clave del producto o servicio en el catálogo del SAT _ClaveProdServ.

unidad Es la unidad de medida del bien o servicio propia de la operación del emisor aplicada a la parte.

noIdentificacion Se puede registrar el número de serie, número de parte o identificador del producto o servicio descrita en la parte.

descripcion Es la descripción del bien o servicio correspondiente a la parte.

valorUnitario Es el valor o precio unitario del bien o servicio que corresponde a la parte, debe de ser mayor a cero.

importe Es el importe total de los bienes o servicios correspondientes a la parte. Debe ser igual a la multiplicación de la cantidad por el valor unitario.

Partidas / Partes / InformacionAduanera [opcional]

{
    "CFDi": {
        ...

        "Partidas": [
            {

                ...

                "Partes": [
                    {
                        ...
                        "InformacionAduanera": {"numeroPedimento": [
                            "15  48  3009  0001234",
                            "15  48  3009  0001234"
                        ]},
                    }
                ]
            }
        ],
        ...

Partidas / Partes / InformacionAduanera

Esta sección de la parte, contiene la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas o se trate de operaciones de comercio exterior de bienes o servicios.

Es condicional porque solo se debe incluir si la parte que se está comercializando es de importación y no se incluye el Complemento de Comercio Exterior.

numeroPedimento Es el número de pedimiento correspondiente a la importación del bien, , en este campo se podrán agregar multiples numero de pedimento.

Las reglas de formación de éste dato (iniciando por la izquierda) son las siguientes:

Últimos dos dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado, iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana.

• Solo se incluye éste campo cuando el comprobante No incluya el complemento de comercio exterior.

Impuestos del Comprobante 4.0

Impuestos [condicional]

{
    "CFDi": {
        ...,
        "Impuestos": {
            "Totales": {
                "retenciones": "95.00",
                "traslados": "232.00"
            },
            "Impuestos": [
                {
                    "tipo": "traslado",
                    "claveImpuesto": "IVA",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.16",
                    "baseImpuesto": "1450.00",
                    "importe": "232.00"
                },
                {
                    "tipo": "retencion",
                    "claveImpuesto": "ISR",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.10",
                    "baseImpuesto": "950.00",
                    "importe": "95.00"
                }
            ]
        },
        ...,

Impuestos / Totales

Esta sección contiene la información relacionada con los impuestos federales retenidos y trasladados del CFDi. Es requerido incluirla siempre que los productos y/o servicios del comprobante tengan impuestos, que en la práctica es la mayoría de las veces.

Totales / retenciones Es el total de los impuestos de retenciones federales. Se debe incluir solo si el comprobante incluye impuestos de retención. En caso contrario, no es necesario incluir el campo.

• Este campo No es requerido cuando solo se envian Impuestos de tipo traslado.

Totales / traslados Es el total de los impuestos de trasladados federales. Se debe incluir solo si el comprobante incluye impuestos de traslado. En caso contrario, no es necesario incluir el campo.

• Este campo No es requerido cuando solo se envian Impuestos de tipo retencion.

Impuestos / Impuestos

Este nodo es requerido cuando al menos una de las partidas es objeto de impuestos.

tipo Es el tipo de impuesto conforme a los disponibles en el catálogo c_Impuesto del SAT.

claveImpuesto Es la clave de impuesto del comprobante conforme al catálogo c_Impuesto del SAT.

tipoFactor Es el tipo de factor que se aplica a la base del impuesto del comprobante.

tasaOCuota Es el valor de la tasa o cuota que aplica para la partida. Éste campo es requerido cuando el campo tipoFactor sea tasa o cuota.

baseImpuesto Campo Requerido para registrar el monto de la base del impuesto trasladado, agrupado por impuesto, tipoFactor y tasaOCuota, el cual debe tener hasta la cantidad de decimales que soporte la moneda.

• No se permiten valores negativos y debe ser igual al redondeo de la suma de los importes de los campos Base trasladados registrados en los conceptos, donde el impuesto del concepto sea igual al campo impuesto de este apartado y la tasaOCuota del concepto sea igual al campo tasaOCuota de este apartado.
• En caso de que solo existan conceptos con tipoFactor exento, la suma de este atributo debe ser igual al redondeo de la suma de los importes de los campos Base registrados en los conceptos.

importe Es el importe del impuesto que aplica a la partida.

• Este campo es requerido cuando el campo tipoFactor se haya registrado como tasa o cuota.
• No se permiten valores negativos.
• Debe de tener el número de decimales que soporte la moneda.
• Debe ser igual al redondeo de la suma de los importes de los impuestos registrados en las partidas que correspondan al mismo tipo.

Bloques de Información Adicional 4.0

Esta sección opcional permite agregar a la versión PDF del comprobante bloques de información no fiscal. Dado que se trata de información no fiscal los campos pueden contener cualquier texto libre siempre y cuando no cause confusión ni contradiga la información fiscal que contiene el resto del comprobante.

Bloques de Información Adicional [opcional]

{
    "CFDi": {
        ...,
        "BloquesInfoAdicional": {
            "BloqueSuperior": {
                "titulo": "Información",
                "texto": "Condiciones: Contado Vencimiento: 17/12/2016"
            },
            "BloqueInferior": {
                "titulo": "Observaciones",
                "TextoRenglones": [
                    "Folio del contrato: C1008008. Factura que ampara el pago de la(s)",
                    "transaccion(es): Pago Transacción 7/48"
                ]
            }
        },
        ...,

BloquesInfoAdicional / BloqueSuperior

Nodo que contiene la información del bloque superior de información adicional (no fiscal) que aparecerá por encima de las partidas del comprobante en la versión PDF.

• Aplican las mismas reglas y estructura que el Bloque Inferior.

BloquesInfoAdicional / BloqueInferior

Nodo que contiene la información del bloque inferior de información adicional (no fiscal) que aparecerá por debajo de los totales del comprobante en la versión PDF.

• Se permite solamente un bloque superior y un bloque inferior.
• Pueden aparecer ambos bloques o solamente uno de los bloques.
• Existen dos opciones para el texto del bloque: un solo bloque de texto libre texto o renglones definidos utilizando la etiqueta TextoRenglones y separando cada renglón con una coma. Se debe utilizar solo una de las dos opciones por petición.

titulo Es el campo que contiene el título del bloque superior o inferior de información adicional.

texto Elemento que contiene el texto que se incluirá en el cuerpo del bloque de información ya sea superior o inferior. En caso de que sea un texto largo, este tendrá saltos de línea naturales al final de cada renglón.

TextoRenglones

Arreglo que contiene los renglones individuales que aparecerán en el cuerpo del bloque de información adicional ya sea superior o inferior. Se recomienda utilizar éste en caso de que se requiera un control más exacto del texto y saltos de línea en el bloque de información. Es necesario dividir cada uno de los renglones con una coma.

• Se puede incluir un máximo de 10 renglones dentro del bloque de información adicional.

Enviar CFDi 4.0

Esta sección opcional contiene la información necesaria para enviar los comprobantes por correo electrónico a los receptores (clientes). Los correos adoptan el diseño del comprobante (indicado en el nodo nombreDiseno) e incluyen el logotipo en caso de que el diseño cuente con uno.

Enviar CFDi [opcional]

{
    "CFDi": {
        ...,
        "EnviarCFDI": {
            "Correos": [
                "facturas@enlacefiscal.com",
                "cuentasxpagar@enlacefiscal.com"
            ],
            "mensajeCorreo": "Mensaje personalizado que se incluirá en el cuerpo del correo a enviar."
        },
        ...,
}

Correos Arreglo para especificar la dirección o direcciones de correo electrónico a la cual se enviará la liga para descargar los archivos PDF y XML del comprobante.

• Si requiere especificar más de una dirección de correo electrónico, es necesario dividir cada dirección con una coma.

mensajeCorreo Elemento para agregar un mensaje opcional que puede incluir el correo electrónico enviado para la descarga del comprobante.

tipo Elemento para indicar el tipo de receptor del correo.

• Cuando el receptor del correo es un sistema, se debe utilizar el tipo sistema para que el formato de correo sea texto plano y se adjunte la versión XML.

Campos Personalizados 4.0

Cuando se desea incluir información adicional (no fiscal) a un comprobante, se pueden utilizar los campos personalizados. Estos son campos de información más cortos en comparación con los Bloques de Información Adicional, se puede incluir información como: Número de Vendedor, Número de Pedido, Vía de Embarque, Ruta, etc.

• Se pueden incluir un máximo de 6 campos personalizados.

Campos Personalizados [opcional]

{
    "CFDi": {
        ...,
        "Personalizados": [
            {
                "nombreCampo": "Número de Pedido",
                "valor": "345673"
            },
            {
                "nombreCampo": "Vendedor",
                "valor": "Juan Pérez"
            }
        ],
        ...,

nombreCampo Es el campo que contiene el título del campo corto, debe tener un máximo de 50 caracteres.

valor Es el campo que contiene el dato del campo personalizado, debe tener un máximo de 100 caracteres.

Pagaré 4.0

De manera opcional se puede incluir la información de un Pagaré en el comprobante. El texto que se utiliza está estandarizado, solo es necesario indicar la fecha de vencimiento y la tasa de interés moratorio que se aplicará en caso de incumplimiento.

Pagaré [opcional]

{
    "CFDi": {
        ...,
        "Pagare": {
            "fecha": "2022-02-17",
            "tasaInteresMoratorio": "5.58"
        }
    }
}

fecha Es la fecha de vencimiento del pagaré.

tasaInteresMoratorio Es la tasa de interés moratorio que se cobraría en caso de que el pago se realice después de la fecha de vencimiento.

Ejemplo Básico 4.0

Ejemplo con el mínimo de campos que puede tener una petición para el timbrado de CFDi.

Ejemplo Básico - Request:

{
  "CFDi": {
    "modo":"debug",
    "versionCFDi": "4.0",
    "versionEF": "6.5",
    "serie": "FA",
    "folioInterno": "1",
    "fechaEmision": "2022-02-01 11:22:01",
    "subTotal": "20.00",
    "total": "23.20",
    "rfc": "AAA010101AAA",
    "exportacion": "01",
    "DatosDePago": {
      "metodoDePago": "PUE",
      "formaDePago": "03"
    },
    "Receptor": {
      "rfc": "BBB010101BB1",
      "nombre": "EMPRESA DEMO",
      "regimenFiscal": "601",
      "usoCfdi": "adquisicion_mercancias",
      "DomicilioFiscal": {          
        "cp": "44580"
      }
    },
    "Partidas": [
      {
        "cantidad": "1",
        "claveUnidad": "KGM",
        "claveProdServ": "42171606",
        "descripcion": "1 Kg de arroz",
        "valorUnitario": "20.00",
        "importe": "20.00",
        "objetoDeImpuesto": "si",
        "Impuestos": [
          {
            "tipo": "traslado",
            "claveImpuesto": "IVA",
            "tipoFactor": "tasa",
            "tasaOCuota": "0.16",
            "baseImpuesto": "20.00",
            "importe": "3.20"
          }
        ]
      }
    ],
    "Impuestos": {
      "Totales": {
        "traslados": "3.20"
      },
      "Impuestos": [
        {
          "tipo": "traslado",
          "claveImpuesto": "IVA",
          "tipoFactor": "tasa",
          "tasaOCuota": "0.16",
          "baseImpuesto": "20.00",
          "importe": "3.20"
        }
      ]
    }
  }
}

Ejemplo Básico - Response:

{
  "AckEnlaceFiscal": {
    "numeroReferencia": "123",
    "estatusDocumento": "aceptado",
    "fechaMensaje": "2017-07-20 11:22:02",
    "version": "1.0",
    "folioInterno": "1",
    "folioFiscalUUID": "4E80053F-74B9-4004-B7B6-09B30781B4F6",
    "serie": "FA",
    "noSerieCertificado": "20001000000200001111",
    "noSerieCertificadoSAT": "20001000000100001111",
    "selloCFDi": "...",
    "selloSAT": "...",
    "cadenaTFD": "...",
    "fechaGeneracionCFDi": "2017-03-27 17:03:09",
    "fechaTFD": "2017-03-27T18:55:05",
    "estadoCFDi": "vigente",
    "descargaArchivoQR": "https://descarga.enlacefiscal.com/QR/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRldsTNmLTc0YjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "descargaArchivoPDF": "https://descarga.enlacefiscal.com/PDF/?i=YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "xmlCFDi": "...",
    "descargaXmlCFDi": "https://descarga.enlacefiscal.com/CFDI/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRlODAwNTNmLTc0dssjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0"
  }
}

Ejemplo Completo 4.0

Ejemplo con la mayoría de campos que puede tener una petición.

Ejemplo Completo Timbrado - Request:

{
   "CFDi": {
        "modo": "debug",
        "versionCFDi": "4.0",
        "versionEF": "6.5",
        "serie": "FA",
        "folioInterno": "1",
        "fechaEmision": "2022-02-01 11:22:01",
        "subTotal": "1500.00",
        "descuentos": "50.00",
        "total": "1587.00",
        "tipoMoneda": "MXN",
        "nombreDisenio": "Diseño predeterminado",
        "rfc": "AAA010101AAA",
        "exportacion": "01",
        "DatosDePago": {
            "metodoDePago": "PUE",
            "formaDePago": "03",
            "condicionesDePago": "45 días",
            "fechaVencimiento": "2022-02-23",
            "referenciaBancaria": "3444232132"
        },
        "ComprobantesRelacionados": [
        {
            "tipoRelacion": "nota_credito",
            "Comprobantes": [
                "eeca15af-e9b1-4a45-9861-8d51c4fa8219",
                "FA-250"
            ]
        },
        {
            "tipoRelacion": "sustitucion",
            "Comprobantes": [
                "aaca15af-e9b1-4a45-9861-8d51c4fa8219",
                "FA-251"
            ]
        }
        ],
        "Receptor": {
            "rfc": "AAA010101AAA",
            "nombre": "EMPRESA DEMO",
            "regimenFiscal": "601",
            "usoCfdi": "adquisicion_mercancias",
            "IdentificadorCliente": {
                "nombreCampo": "Número de Matrícula",
                "valorCampo": "A12332"
            },
            "DomicilioFiscal": {
                "calle": "Rayo",
                "noExterior": "2835",
                "noInterior": "1-A",
                "colonia": "Jardines del norte",
                "localidad": "Guadalajara",
                "municipio": "Guadalajara",
                "estado": "Jalisco",
                "pais": "México",
                "cp": "44580"
            }
        },
        "Partidas": [
            {
                "cantidad": "10",
                "claveUnidad": "E48",
                "unidad": "Unidad de servicio",
                "claveProdServ": "80101500",
                "noIdentificacion": "421412321212321",
                "descripcion": "Servicios de consultoría de negocios y administración corporativa",
                "valorUnitario": "100.00",
                "importe": "1000.00",
                "descuento": "50.00",
                "objetoDeImpuesto": "02",
                "Impuestos": [
                    {
                        "tipo": "traslado",
                        "claveImpuesto": "IVA",
                        "tipoFactor": "tasa",
                        "tasaOCuota": "0.16",
                        "baseImpuesto": "950.00",
                        "importe": "152.00"
                    },
                    {
                        "tipo": "retencion",
                        "claveImpuesto": "ISR",
                        "tipoFactor": "tasa",
                        "tasaOCuota": "0.10",
                        "baseImpuesto": "950.00",
                        "importe": "95.00"
                    }
                ],
                "ACuentaTerceros": {
                    "rfc": "AAA010101AAA",
                    "nombre": "Empresa Demo, S.A. de C.V.",
                    "regimenFiscal": "601",
                    "cp": "44580"
                },
                "InformacionAduanera": {"numeroPedimento": [
                    "15  48  3009  0001234",
                    "15  48  3009  0001234"
                ]},
                "Partes": [
                    {
                        "cantidad": "10",
                        "claveProdServ": "27111731",
                        "unidad": "Pieza",
                        "noIdentificacion": "R-DSA2332",
                        "descripcion": "Desarmador",
                        "valorUnitario": "100.00",
                        "importe": "1000.00"
                    },
                    {
                        "cantidad": "5",
                        "claveProdServ": "27111750",
                        "unidad": "Pieza",
                        "noIdentificacion": "R-DSC2345",
                        "descripcion": "Pinzas",
                        "valorUnitario": "50.00",
                        "importe": "250.00",
                        "InformacionAduanera": {"numeroPedimento": [
                            "15  48  3009  0001234",
                            "15  48  3009  0001234"
                        ]}
                    }
                ]
            },
            {
                "cantidad": "1",
                "claveUnidad": "E48",
                "unidad": "Servicio",
                "claveProdServ": "84101700",
                "descripcion": "Renta",
                "valorUnitario": "500.00",
                "importe": "500.00",
                "objetoDeImpuesto": "02",
                "Impuestos": [{
                    "tipo": "traslado",
                    "claveImpuesto": "IVA",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.16",
                    "baseImpuesto": "500.00",
                    "importe": "80.00"
                }],
                "CuentaPredial": {"numero": [
                    "49199",
                    "48188"
                ]}
            }
        ],
        "Impuestos": {
            "Totales": {
                "retenciones": "95.00",
                "traslados": "232.00"
            },
            "Impuestos": [
                {
                    "tipo": "traslado",
                    "claveImpuesto": "IVA",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.16",
                    "baseImpuesto": "1450.00",
                    "importe": "232.00"
                },
                {
                    "tipo": "retencion",
                    "claveImpuesto": "ISR",
                    "tipoFactor": "tasa",
                    "tasaOCuota": "0.10",
                    "baseImpuesto": "950.00",
                    "importe": "95.00"
                }
            ]
        },
        "BloquesInfoAdicional": {
            "BloqueSuperior": {
                "titulo": "Información",
                "texto": "Condiciones: Contado Vencimiento: 17/12/2016"
            },
            "BloqueInferior": {
                "titulo": "Observaciones",
                "TextoRenglones": [
                    "Folio del contrato: C1008008. Factura que ampara el pago de la(s)",
                    "transaccion(es): Pago Transacción 7/48"
                ]
            }
        },
        "EnviarCFDI": {
            "Correos": [
                "facturas@enlacefiscal.com",
                "cuentasxpagar@enlacefiscal.com"
            ],
            "mensajeCorreo": "Mensaje personalizado que se incluirá en el cuerpo del correo a enviar."
        },
        "Personalizados": [
            {
                "nombreCampo": "Número de Pedido",
                "valor": "345673"
            },
            {
                "nombreCampo": "Vendedor",
                "valor": "Juan Pérez"
            }
        ],
        "Pagare": {
            "fecha": "2017-04-01",
            "tasaInteresMoratorio": "5.58"
        }
    }
}  

Ejemplo Completo Timbrado - Response:

{
  "AckEnlaceFiscal": {
    "numeroReferencia": "123",
    "estatusDocumento": "aceptado",
    "fechaMensaje": "2017-07-20 11:22:02",
    "version": "1.0",
    "folioInterno": "1",
    "folioFiscalUUID": "4E80053F-74B9-4004-B7B6-09B30781B4F6",
    "serie": "FA",
    "noSerieCertificado": "20001000000200001111",
    "noSerieCertificadoSAT": "20001000000100001111",
    "selloCFDi": "...",
    "selloSAT": "...",
    "cadenaTFD": "...",
    "fechaGeneracionCFDi": "2017-03-27 17:03:09",
    "fechaTFD": "2017-03-27T18:55:05",
    "estadoCFDi": "vigente",
    "descargaArchivoQR": "https://descarga.enlacefiscal.com/QR/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRldsTNmLTc0YjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "descargaArchivoPDF": "https://descarga.enlacefiscal.com/PDF/?i=YjMwNzgxYjRmNi0tMS0tMTg=&b=0",
    "xmlCFDi": "...",
    "descargaXmlCFDi": "https://descarga.enlacefiscal.com/CFDI/?i=QUFBMDEwMTAxQUFBLS0yMDE3XzE4XzRlODAwNTNmLTc0dssjktNDAwNC1iN2I2LTA5YjMwNzgxYjRmNi0tMS0tMTg=&b=0"
  }
}

Peticiones ejemplo 4.0

Catálogos SAT CFDi 4.0

En esta sección podrás encontrar los nuevos Catálogos del SAT de la versión 4.0 necesarios para poder realizar peticiones al API de Enlace Fiscal.

Forma De Pago 4.0

En éste catálogo se describen las opciones que se pueden utilizar para la etiqueta de formaDePago, en la petición se puede incluir el campo de Claveo Clave Texto.

La opción de Clave Texto es más sencilla ya que indica de manera más clara la opción del catálogo. En caso de utilizar ésta opción, el API de Enlace Fiscal lo traduce de manera automática a la clave del catálogo del SAT para cumplir con las reglas del Anexo 20 de la Resolución Miscelánea Fiscal.

Catálogo de Forma de Pago (c_FormaPago)

Validación cuenta ordenante o destinatario

Cuando se emite un recibo electrónico de pagos, si se decide capturar el dato ctaOrdenante o ctaBeneficiario, es necesario tomar en cuenta que el valor a enviar pasará por una validación que depende del atributo formaDePago enviado. Lo anterior aplica para las formas de pago bancarizadas.

Impuestos 4.0

En éste catálogo se describen las opciones que se pueden utilizar para la etiqueta de claveImpuesto, en la petición se puede incluir el campo de Claveo Clave Texto.

La opción de Clave Texto es más sencilla ya que indica de manera más clara la opción del catálogo. En caso de utilizar ésta opción, el API de Enlace Fiscal lo traduce de manera automática a la clave del catálogo del SAT para cumplir con las reglas del Anexo 20 de la Resolución Miscelánea Fiscal.

Catálogo de Impuestos (c_Impuesto)

Método de Pago 4.0

En éste catálogo se describen las opciones que se pueden utilizar para la etiqueta de metodoDePago.

Catálogo de Método de Pago (c_MetodoPago)

Países 4.0

En éste catálogo se describen las opciones de países que se pueden utilizar para la etiqueta de pais.

Países más utilizados

Cátalogo de Países (c_Pais)

Tipo de Cadena de Pago 4.0

Catálogo que describe las opciones de tipo de cadena de pago que se pueden utilizar para la etiqueta tipoCadPago. Ésta etiqueta se utiliza en el Recibo Electrónico de Pago.

Catálogo Tipo de Cadena de Pago (c_TipoCadenaPago)

Tipo de Monedas 4.0

En éste catálogo se describen las opciones de moneda que se pueden utilizar para la etiqueta de tipoMoneda.

La columna Número de decimales indica el número máximo de decimales que soporta cierta moneda. En el caso de que se tenga un importe con más decimales de los permitidos por la moneda, se tiene que hacer un redondeo.

La columna Porcentaje de variación indica el rango de variación permitido en el tipo de cambio para no tener que solicitar un código de confirmación para poder emitir un comprobante.

Monedas más utilizadas

Catálogo de Monedas (c_Moneda)