Ir al contenido

Reimprimir un voucher

PRINT con print.voucher reimprime el voucher de una transacción aprobada que el POS ya registró: la copia del comercio, la del cliente o ambas.

POST /api/v1/pos-operations
Ambiente URL base API
Integración https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c
Producción https://ms-payment-c2c.virtualpos.cl/ms-payment-c2c
Nombre Requerido Descripción
Content-Type Sí application/json
X-Api-Key Sí Tu API key.
Campo Tipo Requerido Descripción
posSerial string Sí Serial del POS donde se hizo la transacción.
operationType string Sí PRINT
externalPaymentId string Sí ID nuevo para cada reimpresión. Si repites uno de una reimpresión ya aprobada, no se imprime de nuevo (ver idempotencia).
print.voucher object Sí Transacción a reimprimir. Ver abajo.
callbackUrl string No URL donde recibirás los webhooks.

Envía copy y exactamente uno de los dos identificadores:

Campo Requerido Descripción
copy Sí commerce (copia comercio), customer (copia cliente) o both. No distingue mayúsculas.
pos_transaction_id Uno de los dos El posTransactionId de la transacción, informado en el resultado de la venta. Máximo 128 caracteres. Alias: posTransactionId.
operational_tid Uno de los dos El TID operacional impreso en el voucher: los 10 caracteres completos, con o sin guiones o espacios. Se valida su dígito verificador. Alias: operationalTid.

Reglas:

  • Los valores deben ser strings.
  • No envíes un campo y su alias a la vez, por ejemplo pos_transaction_id y posTransactionId.
  • voucher no se combina con lines ni copies: son dos modos distintos de PRINT.
  • El POS imprime solo si encuentra una única transacción aprobada que coincida.

Por ID de transacción, ambas copias:

{
"posSerial": "VPOS-1A2B3C4D5E",
"operationType": "PRINT",
"externalPaymentId": "reprint-10234-1",
"callbackUrl": "https://tu-sistema.cl/webhooks/virtualpos",
"print": {
"voucher": {
"pos_transaction_id": "1b39fb38-8625-400c-8b5e-0f95886a5a08",
"copy": "both"
}
}
}

Por TID impreso en el voucher, copia del cliente:

{
"posSerial": "VPOS-1A2B3C4D5E",
"operationType": "PRINT",
"externalPaymentId": "reprint-10234-2",
"print": {
"voucher": {
"operational_tid": "00288-NHGGV",
"copy": "customer"
}
}
}