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 |
Headers
Sección titulada «Headers»| 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. |
Objeto print.voucher
Sección titulada «Objeto print.voucher»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_idyposTransactionId. voucherno se combina conlinesnicopies: son dos modos distintos dePRINT.- El POS imprime solo si encuentra una única transacción aprobada que coincida.
Ejemplos de request
Sección titulada «Ejemplos de request»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" } }}