Emitir factura electrónica en una sola llamada API
Cómo usar issue-and-submit con externalId, los scopes de emisión, respuestas 202 y conciliación segura de resultados inciertos DGI.
Para qué sirve la operación única
La API nativa puede crear o recuperar un borrador, prepararlo, firmarlo y tratar de enviarlo a DGI con una sola solicitud del integrador. Internamente conserva los controles fiscales del flujo de múltiples pasos.
Esta capacidad no equivale a aceptación inmediata ni a un adaptador compatible con APIs ajenas. El servidor exige documents:write y documents:submit y un externalId obligatorio.
Llamada de ejemplo en TEST
Reemplazá la empresa y datos por registros válidos de TEST. El ejemplo muestra formato HTTP y no constituye garantía de CFE fiscalmente válido.
curl -X POST "https://factumel.com/api/v1/documents/issue-and-submit" \
-H "Authorization: Bearer $FACTUMEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"companyId":"EMPRESA_TEST","externalId":"venta-1001","documentType":"111","currencyCode":"UYU","items":[{"description":"Servicio","quantity":1,"unitPrice":1000,"taxRate":22}]}'Respuestas y conciliación
Un HTTP 202 significa que la operación está pendiente. Un HTTP 200 puede incluir un estado final; sólo data.status=ACCEPTED significa aceptación. Ante un fallo después de crear, la respuesta intenta conservar documentId y externalId; ante pérdida completa de respuesta, consultá /api/v1/documents/lookup por el mismo externalId.
Nunca generes otro externalId para forzar un segundo envío. En producción esta ruta está deshabilitada por defecto hasta activación del operador con API_ONE_SHOT_LIVE_ENABLED=true y revisión fiscal previa.