Operaciones disponibles de las bandejas
Referencia técnica para operaciones disponibles de las bandejas dentro del cliente local.
Objetivo
Esta guía resume las operaciones disponibles en las bandejas REST y de intercambio de archivos.
Operaciones REST
GET /health
Uso:
- prueba rapida de vida del daemon
- discovery de la URL base
GET /state
Uso:
- monitoreo
- diagnostico
- soporte
POST /enqueue
Uso:
- entrada asincronica
- el integrador no necesita serie y numero en el mismo request
Resultado:
- devuelve aceptacion del trabajo
- no implica emision final
POST /sign-cfe
Uso:
- emision sincronica
- numeracion, firma y respuesta inmediata
Regla de exito:
- HTTP
200 CodigoRespuesta = "00"SerieyNumerono nulos
Interpretacion de CodigoRespuesta:
| CodigoRespuesta | Significado | Criterio de integracion |
|---|---|---|
00 | Exito | El comprobante puede considerarse emitido localmente |
01 | Peticion denegada | El comprobante no debe considerarse emitido; revisar permisos o estado del UUID |
03 | Comercio invalido | El codigo de comercio enviado no corresponde a un perfil configurado |
12 | Requerimiento invalido | Faltan campos o el request no cumple el contrato esperado |
30 | Error en formato | El cuerpo del request no pudo interpretarse correctamente |
31 | Error en formato de CFE | El XML/CFE fue rechazado por validacion local |
89 | Terminal invalida | La terminal enviada no corresponde al comercio configurado |
96 | Error interno, permisos, firma, persistencia, rango o envio | El comprobante no debe considerarse emitido; revisar MensajeRespuesta y logs |
Regla recomendada:
- considerar emitido solo si
HTTP 200,CodigoRespuesta = "00"ySerie+Numerovienen informados - ante cualquier otro codigo, tomar
MensajeRespuestacomo el diagnostico funcional principal
POST /reprint
Uso:
- reimpresion de un comprobante ya emitido
- por
uuido portipo_cfe + serie + numero
Resultado:
- encola impresion
- no devuelve el PDF
POST /pdf
Uso:
- obtener el PDF binario de un comprobante emitido
- previsualizar o archivar
Resultado:
HTTP 200Content-Type: application/pdf
GET /proximo-serie-nro
Uso:
- consultar el siguiente folio local disponible
- verificar rango activo
POST /validar-xml
Uso:
- validar estructura y reglas locales antes de emitir
POST /existe-constancia
Uso:
- verificar si un comprobante ya fue registrado localmente
Operaciones por archivos
Archivo JSON en bandeja
Uso:
- integracion asincronica simple por archivos
Archivo TXT 310
Uso:
- integracion por archivo con respuesta estructurada
311