Operación enqueue

Objetivo

POST /enqueue acepta un comprobante en la bandeja local para procesamiento asíncrono.

No confirma emisión final. Confirma aceptación local del trabajo.

Endpoint

POST /enqueue

Cuándo usarlo

• flujos desacoplados
• procesamiento en cola local
• escenarios donde la app no necesita el XML firmado en la misma llamada

Campos de request

Ejemplo de request

curl -X POST http://127.0.0.1:18787/enqueue \
  -H 'Content-Type: application/json' \
  -d '{
    "tipo_cfe": 101,
    "uuid": "venta-pos-000124",
    "cod_comercio": "1",
    "cod_terminal": "1",
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><CFE xmlns=\"http://cfe.dgi.gub.uy\" version=\"1.0\"><eTck>...</eTck></CFE>",
    "send_now": true
  }'

Campos de response

Ejemplo de response exitosa

{
  "ok": true,
  "stored_path": "/ruta/local/inbox/20260429190500124-venta-pos-000124.json",
  "uuid": "venta-pos-000124",
  "send_now": true
}

Qué significa esta respuesta

• confirma aceptación local del trabajo
• no garantiza que el comprobante ya haya quedado firmado o aceptado
• la aplicación debe tratarlo como confirmación de bandeja, no como resultado fiscal final

Escenarios de error típicos

xml faltante

Resultado esperado:

• rechazo temprano del request
• mensaje típico: xml es obligatorio

uuid faltante

Resultado esperado:

• rechazo temprano del request
• mensaje típico: uuid es obligatorio

ruteo inválido

Resultado esperado:

• rechazo temprano o imposibilidad de resolver perfil
• mensaje típico: No se encontró perfil para cod_comercio=X cod_terminal=Y

XML inválido

Resultado esperado:

• rechazo durante la validación local previa
• el trabajo no debería considerarse aceptado

Regla de integración

Considerar éxito de enqueue solo como:

• aceptación local del request

No como:

• comprobante firmado
• comprobante enviado
• comprobante aceptado fiscalmente