Operación reprint

Referencia técnica para operación reprint dentro del cliente local.

Bandeja REST local Arquitectura FFI Recuperación

Objetivo

POST /reprint solicita la reimpresión de un comprobante ya emitido.

Endpoint

POST /reprint

Cuándo usarlo

reimpresión por pedido del usuario
reposición de ticket o comprobante
recuperación operativa cuando la salida física falló

Formas de localizar el comprobante

Se puede ubicar por:

uuid
o tipo_cfe + serie + numero

La forma más estable sigue siendo uuid.

Campos de request

Campo	Obligatoriedad	Descripción
`uuid`	recomendado	Identificador externo del comprobante
`impresora`	recomendado	Destino y parámetros de impresión
`variant`	opcional	Variante o plantilla
`fallback_copies`	opcional	Copias de respaldo
`cod_comercio`	condicional	Contexto de ruteo
`cod_terminal`	condicional	Contexto de ruteo
`tipo_cfe`	alternativo	Usar si no se localiza por `uuid`
`serie`	alternativo	Usar si no se localiza por `uuid`
`numero`	alternativo	Usar si no se localiza por `uuid`

Ejemplo de request

curl -X POST http://127.0.0.1:18787/reprint \
  -H 'Content-Type: application/json' \
  -d '{
    "uuid": "venta-pos-000123",
    "impresora": "CajaFiscal;FORMATO=personalizado;COPIAS=2",
    "variant": "personalizado",
    "fallback_copies": 2,
    "cod_comercio": "1",
    "cod_terminal": "1"
  }'

Campos de response

Campo	Cuándo aparece	Descripción
`ok`	siempre	Resultado técnico
`queued`	éxito	Indica que la reimpresión fue aceptada

Ejemplo de response exitosa

{
  "ok": true,
  "queued": true
}

HTTP esperada

202 Accepted

Escenarios de error típicos

comprobante no encontrado

Resultado esperado:

la reimpresión no queda aceptada

impresora inválida o mal configurada

Resultado esperado:

rechazo del request o error en ejecución posterior

parámetros de ruteo inconsistentes

Resultado esperado:

imposibilidad de ubicar el comprobante dentro del perfil indicado

falta de referencia suficiente

Resultado esperado:

si no se envía uuid, ni combinación suficiente de tipo_cfe + serie + numero, la operación no debería poder resolverse

Recomendaciones

usar uuid como referencia primaria
conservar configuración de impresora por puesto o por caja
separar la emisión fiscal de la reimpresión en la lógica del integrador