Introducción

Conecta cualquier sistema (TPV, ERP, eCommerce, etc) con nuestra API REST para emitir Comprobantes Fiscales Digitales en México.

Tenemos ejemplos de implementación en diferentes lenguajes de programación como: Shell.

Para generar tus credenciales de API ve a app.facturabilidad.com/v3 elige el RFC a conectar, ve al menú Ajustes->Api y da click en el botón Generar nueva credencial.

Autenticación

Para usar el API se requiere Autenticación HTTP básica.

# Agrega el Header Authorization en cada petición
api_id='API_ID'
api_secret='API_SECRET'
token=$(echo -ne "$api_id:$api_secret" | base64 --wrap 0)

curl "http://backend.pruebas.facturabilidad.com/api"\
  -H "Authorization: Basic $token"

Reemplaza API_ID y API_SECRET con tus credenciales.

La cabecera de Autorización se construye como sigue:

1. API_ID y API_SECRET se combinan en una cadena "API_ID:API_SECRET".
2. La cadena resultante se codifica en Base64.
3. El método de autorización y un espacio, es decir, "Basic " se pone a continuación, antes de que la cadena sea codificada. Por ejemplo, si el API_ID es '123456' y el API_SECRET es 'EWQ321', la cabecera estará formada de la siguiente manera:

Authorization: Basic MTIzNDU2OkVXUTMyMQ==

CFDI

Guardar CFDI

Envía una petición POST con el CFDI en formato JSON. Opcionalmente se puede timbrar el CFDI al mismo tiempo.

# Enviar el cfdi en formato JSON, 
# puedes usar -d @ para indicar un archivo que contenga el JSON
# o directamente pasar la cadena JSON con -d '$json_cfdi'
curl "http://backend.pruebas.facturabilidad.com/api/Cfdi/guardar"\
    -H "Authorization: Basic $token"\
    -d @cfdi.json # -d '{"Emisor":{ ... } ... }'

Envía el CFDI en formato JSON por POST

HTTP Request

Productivo:

POST https://backend.facturabilidad.com/api/Cfdi/guardar

Pruebas:

POST http://backend.pruebas.facturabilidad.com/api/Cfdi/guardar

Éste método regresa el código HTTP 200 en caso de éxito y una respuesta JSON.

Y regresará el código HTTP 400 si falla alguna validación y la respuesta String indicando lo que se debe corregir.

A continuacion se muestra un ejemplo del objeto json que se espera en la petición. cfdi.json

{ "timbrar": true "cfdi": { "id":null, "Comprobante": { "Complemento": { "ImpuestosLocales": { "prefix": "implocal:", "RetencionesLocales": [], "TotaldeRetenciones": 0, "TotaldeTraslados": 5, "TrasladosLocales": [ { "ImpLocTrasladado": "5 al millar", "Importe": 5, "TasadeTraslado": 0.5 } ], "version": "1.0" } }, "Conceptos": { "Concepto": [ { "_Iva": false, "Cantidad": 1, "ClaveProdServ": "10214001", "ClaveUnidad": "H87", "CuentaPredial": [], "Descripcion": "cosa", "Descuento": "", "Importe": 120.89, "NoIdentificacion": "21", "ObjetoImp": "01", "Unidad": null, "ValorUnitario": "120.890000" } ] }, "CondicionesDePago": "", "Confirmacion": "", "Descuento": "", "Emisor": { "Nombre": "ESCUELA KEMPER URGATE", "RegimenFiscal": "626", "Rfc": "EKU9003173C9" }, "Exportacion": "01", "Fecha": "2023-08-16T02:31:38", "FormaPago": "03", "LugarExpedicion": "43909", "MetodoPago": "PUE", "Moneda": "MXN", "Receptor": { "DomicilioFiscalReceptor": "43909", "Nombre": "Publico X", "NumRegIdTrib": null, "RegimenFiscalReceptor": "616", "ResidenciaFiscal": null, "Rfc": "XAXX010101000", "UsoCFDI": "S01" }, "Sello": null, "Serie": "", "SubTotal": "120.89", "TipoCambio": null, "TipoDeComprobante": "I", "Total": "125.89", "Version": "4.0", "xmlns:implocal": "http://www.sat.gob.mx/implocal", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "xsi:schemaLocation": "http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd http://www.sat.gob.mx/implocal http://www.sat.gob.mx/sitio_internet/cfd/implocal/implocal.xsd" } } }

la propiedad timbrar indica si se desea timbrar el cfdi o solo guardarlo para obtener una vista previa del PDF. Una vez que un cfdi se ha guardado en la respuesta se regresa el id del cfdi generado.

Para modificar un cfdi previamente guardado se debe enviar una peticion POST a la ruta /api/Cfdi/guardar con el id del cfdi a modificar en la propiedad id en el objeto cfdi. Solo se pueden modificar los cfdi que no han sido timbrados.

HTTP Response

Timbrar CFDI

Permite timbrar un cfdi previamente guardado. Pude hacer una petición POST o GET a la ruta /api/Cfdi/timbrar/{id} donde id es el id del cfdi que se desea timbrar.

# Envia solicitud GET para timbrar el cfdi con id 337
curl "http://backend.pruebas.facturabilidad.com/api/Cfdi/timbrar/337"\
    -H "Authorization: Basic $token"\

HTTP Request

Productivo:

POST https://backend.facturabilidad.com/api/Cfdi/timbra/{id}

Pruebas:

POST http://backend.pruebas.facturabilidad.com/api/Cfdi/timbra/{id}

HTTP Response

Recuperar CFDI previamente guardado

Permite recuperar un cfdi previamente guardado. Pude hacer una petición GET a la ruta /api/Cfdi//json/{id} donde id es el id del cfdi que se desea recuperar.

# Envia solicitud GET para recuperar el cfdi con id 337
curl "http://backend.pruebas.facturabilidad.com/api/Cfdi/json/337"\
    -H "Authorization: Basic $token"\

HTTP Request

Productivo:

GET https://backend.facturabilidad.com/api/Cfdi/json/{id}

Pruebas:

HTTP Response

Recuperar XML de un CFDI previamente guardado

Permite recuperar el xml de un cfdi previamente guardado. Pude hacer una petición GET a la ruta /api/Cfdi/xml/{id} donde id es el id del cfdi que se desea recuperar.

# Envia solicitud GET para recuperar el cfdi con id 337
curl "http://backend.pruebas.facturabilidad.com/api/Cfdi/xml/337"\
    -H "Authorization: Basic $token"\

HTTP Request

Productivo:

GET https://backend.facturabilidad.com/api/Cfdi/xml/{id}

Pruebas:

HTTP Response

Recuperar PDF de un CFDI previamente guardado

Permite recuperar el pdf de un cfdi previamente guardado. Pude hacer una petición GET a la ruta /api/Cfdi/pdf/{id} donde id es el id del cfdi que se desea recuperar.

# Envia solicitud GET para recuperar el cfdi con id 337
curl "http://backend.pruebas.facturabilidad.com/api/Cfdi/pdf/337"\
    -H "Authorization: Basic $token"\

HTTP Request

Productivo:

GET https://backend.facturabilidad.com/api/Cfdi/pdf/{id}

Pruebas:

HTTP Response