FacturaDigital CFDI 3.3 API Reference

API para la generación de Facturas Electrónicas CFDI versión 3.3

Permite la generación de CFDIs simples y con complementos, basados en la estructura de los XSD publicados por el SAT. Funciones:

  • Generación de XML y PDF
  • Cancelación de UUIDs
  • Envío por Correo
  • Consulta de créditos (timbres) disponibles en la cuenta
  • Validación de credenciales
API Endpoint
https://app.facturadigital.com.mx/api/cfdi
Schemes: https
Version: v4.2

Paths

Validar credenciales de conexión API

POST /validarusuario

Valida el usuario y la contraseña para realizar el timbrado de CFDI version 3.3 en FacturaDigital.

Accept

Formato de la respuesta. Puedes utilizar los siguientes formatos: application/json application/xml application/array application/jsonp

type
string application/json
in
header
api-usuario

Usuario con el que te registraste en app.facturadigital.com.mx

type
string demo33
in
header
api-password

Contraseña de la cuenta con la que ingresas a tu panel.

type
string demo
in
header
200 OK

Validación exitosa

Consultar créditos disponibles

POST /creditos

Consulta los créditos (timbres) disponibles en la cuenta.

Accept

application/json application/xml application/array application/jsonp

type
string application/json
in
header
api-usuario

Usuario con el que te registraste en app.facturadigital.com.mx

type
string demo33
in
header
api-password

Contraseña de la cuenta con la que ingresas a tu panel.

type
string demo
in
header
200 OK

Consulta exitosa

Generar CFDI 3.3

POST /generar

Genera un CFDI en versión 3.3, a partir del objeto JSON. La respuesta devuelve un arreglo con todos los datos requeridos del CFDI como Sello, Cadena Original, Fecha de Timbrado, así como la URL para descargar el PDF via HTTP Request, así como el string del XML timbrado.

El campo XmlBase64 contiene el string del XML timbrado, pero codificado en Base64 para evitar conflictos de comunicación. Este string debes decodificarlo y guardarlo localmente en tu servidor. Ejemplo: $xml = base64_decode($response->XmlBase64)

La estructura del JSON es la misma estructura utilizada por la documentación publicada en el portal del SAT, así como para los complementos de pagos, nómina, aerolineas, educativo, etc. Si tienes dudas, puedes solicitar un ejemplo en soporte@facturadigital.com.mx

Accept

Formato de la respuesta. Puedes utilizar los siguientes formatos: application/xml application/array application/jsonp

type
string application/jsonp
in
header
api-usuario

Usuario con el que te registraste en app.facturadigital.com.mx

type
string demo33
in
header
api-password

Contraseña de la cuenta con la que ingresas a tu panel.

type
string demo
in
header
jsoncfdi

(no description)

type
string { "Serie": "F", "Folio": 6741, "Fecha": "AUTO", "FormaPago": "01", "CondicionesDePago": "CONDICIONES", "SubTotal": "100.00", "Descuento": null, "Moneda": "MXN", "TipoCambio": 1, "Total": "116.00", "TipoDeComprobante": "I", "MetodoPago": "PUE", "LugarExpedicion": "67150", "LeyendaFolio": "FACTURA", "Emisor": { "RegimenFiscal": "612" }, "Receptor": { "Rfc": "NDI120326HF5", "Nombre": "Novatech Digital SA de CV", "NumRegIdTrib": "", "UsoCFDI": "G03", "Calle": "Palmas", "NoExt": "9810", "NoInt": null, "Colonia": "Anahuac", "Localidad": null, "Referencia": null, "Municipio": "Apodaca", "Estado": "Nuevo Leon", "Pais": "México", "CodigoPostal": "67349" }, "Conceptos": [ { "ClaveProdServ": "01010101", "NoIdentificacion": "01", "Cantidad": 1, "ClaveUnidad": "KGM", "Unidad": "Kilo", "Descripcion": "ESTRUCTURA DE ACERO INOXIDABLE SKX478", "ValorUnitario": "100.00", "Importe": "100.00", "Impuestos": { "Traslados": [ { "Base": "100.00", "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.160000", "Importe": "16.00" } ] } } ], "Impuestos": { "TotalImpuestosTrasladados": "16.00", "Traslados": [ { "Impuesto": "002", "TipoFactor": "Tasa", "TasaOCuota": "0.160000", "Importe": "16.00" } ] }}
in
formData
200 OK

Consulta exitosa

Cancelar UUID

POST /cancelar

Cancela directamente en el SAT el UUID proporcionado. Importante: esta función unicamente está disponible en ambientes de productivo y no tiene forma de "descancelar".

Se puede consumir utilizando UUIDs de prueba o que no han sido transmitidos al SAT, pero devolverá un mensaje de que el UUID no se encuentra, lo cual es normal.

Accept

application/json application/xml application/array application/jsonp

type
string application/json
in
header
api-usuario

Usuario con el que te registraste en app.facturadigital.com.mx

type
string demo33
in
header
api-password

Contraseña de la cuenta con la que ingresas a tu panel.

type
string demo
in
header
uuid

Folio UUID del CFDI que deseas cancelar.

type
string 02513B22-7352-4067-9EE5-2309FBC237BC
in
header
200 OK

Consulta exitosa

Enviar CFDI por E-Mail

POST /correo

Envío de PDF y XML del CFDI por correo electrónico.

Accept

application/json application/xml application/array application/jsonp

type
string application/json
in
header
api-usuario

Usuario o RFC de tu cuenta

type
string demo33
in
header
api-password

Contraseña de tu cuenta

type
string demo
in
header
uuid

Folio UUID del CFDI que deseas enviar por correo.

type
string 02513B22-7352-4067-9EE5-2309FBC237BC
in
header
destinatario

Dirección de correo electrónico del destinatario. Puedes separar varias direcciones por coma.

type
string soporte@facturadigital.com.mx
in
header
cco

Dirección de correo electrónico para Copia Oculta. Puedes separar varias direcciones por coma.

type
string
in
header
mensaje

Mensaje anexo al correo electrónico. Se acepta HTML.

type
string
in
header
200 OK

Peticion exitosa

Schema Definitions