URL PRUEBAS: POST https://facturacion.789.mx/api/v40/test/factura/masivo
URL PRODUCCIÓN: POST https://facturacion.789.mx/api/v40/factura/masivo
| Key | Tipo | Value |
|---|---|---|
| file | File |
Este campo recibe un archivo que contiene un JSON con los datos necesarios para el timbrado masivo de facturas CFDI. El archivo debe enviarse como parte del cuerpo de la solicitud. Asegúrate de que el JSON siga la estructura definida por el API para garantizar un procesamiento exitoso. |
| Nodo | Tipo | Descripción | |||
|---|---|---|---|---|---|
| facturas | array | Este nodo contiene un arreglo de facturas que serán procesadas para timbrado masivo. Cada elemento del arreglo representa una factura individual y debe incluir un identificador único proporcionado por el sistema que consume la API. Este identificador permite la trazabilidad del documento en ambos sistemas. | |||
| data | object | Contiene el cuerpo del JSON con los campos correspondientes al tipo de factura que se está enviando, como Ingresos, Egresos, Complemento de pago, Complemento iedu, Complemento detallista, Complemento carta porte, Complemento comercio exterior, Addenda mavi y Addenda walmart. | |||
| data.data | object | Define la estructura específica de cada tipo de factura, con datos como emisor, receptor, conceptos e impuestos, etc. | |||
|
Identificador requerido |
string |
Este campo es obligatorio y debe contener el ID primario (Primary Key) de la factura en el sistema o aplicación que consume la API. El valor del identificador permitirá la trazabilidad precisa del documento en ambos sistemas. Cuando se actualice el estado de la factura, la API enviará una notificación al webhook proporcionado, incluyendo el identificador original del documento. Debe ser un valor único, preferentemente numérico o alfanumérico, que coincida con la llave primaria de la factura en el sistema del cliente. |
|||
|
webhook requerido |
string | Debe contener la URL del webhook donde la API enviará notificaciones sobre el estado del timbrado de cada factura procesada. A través de esta notificación, se enviará la respuesta del timbrado junto con el identificador único de cada factura, permitiendo al sistema que consumió la API actualizar su estado en tiempo real. | |||