Paso 1: Crea tu cuenta y tu API key
Entra a partners.html, inicia sesion con Google y crea tu primera API key desde el dashboard.
Guarda tu API key en un secrets manager. Las llaves no deben vivir en el frontend ni en repositorios.
Paso 2: Configura tu webhook
FacturaGPT procesa facturas de forma asincrona. Para produccion, el patron recomendado es recibir el resultado final por webhook.
- Configura la URL en el dashboard o usa webhook_url por request.
- Haz que tu endpoint responda 200 OK rapido.
- Procesa la logica pesada en background.
Paso 3: Envia tu primer request
El request principal es POST /api/v1/get_factura. Debes enviar el ticket y el perfil fiscal del receptor.
POST /api/v1/get_factura
curl -X POST https://api.facturagpt.com.mx/api/v1/get_factura \
-H "Authorization: Bearer fgpt_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"external_id": "expense_12345",
"ticket_image": "<base64-encoded image>",
"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"
}'Paso 4: Guarda identifiers y espera el resultado
La respuesta inicial devuelve processing, session_id y datos OCR. Guarda siempre external_id y session_id.
202 Accepted
{
"ok": true,
"data": {
"session_id": "id_abc123",
"external_id": "expense_12345",
"status": "processing"
}
}Paso 5: Usa status polling como complemento
El endpoint de estatus sirve para reconciliacion o verificacion posterior al webhook.
GET /api/v1/get_factura_status/{session_id}
curl -H "Authorization: Bearer fgpt_live_your_api_key_here" \
https://api.facturagpt.com.mx/api/v1/get_factura_status/id_abc123