Authentication
Todas las requests requieren una API key en el header Authorization.
Headers
Authorization: Bearer fgpt_live_your_api_key_here
Content-Type: application/jsonPOST /api/v1/get_factura
Inicia el proceso de generacion de CFDI a partir de un ticket.
- external_id: requerido
- ticket_image: requerido
- customer_id o user_info o csf_pdf
- save_customer, uso_cfdi, payment_method, webhook_url, test_mode son opcionales
Request body
{
"external_id": "expense_12345",
"ticket_image": "<base64-encoded image>",
"save_customer": true,
"uso_cfdi": "G03",
"payment_method": "28",
"user_info": {
"razon_social": "ACME SA DE CV",
"rfc": "XAXX010101000",
"email": "finance@acme.com",
"regimen": "601",
"cp": "11560"
},
"webhook_url": "https://your-server.com/webhooks/facturagpt",
"test_mode": false
}GET /api/v1/get_factura_status/{session_id}
Consulta el estado actual de una sesion de facturacion. Util para reconciliacion o fallback despues del webhook.
GET /api/v1/get_factura_files/{session_id}
Obtiene los links del XML y PDF cuando la sesion ya esta en completed.
GET /api/v1/files/{session_id}/{file_type}
Descarga un archivo final. file_type puede ser xml o pdf.
Estados de sesion
- processing: request aceptado, automatizacion en curso
- completed: factura generada con exito
- failed: no se genero el CFDI