Crear orden de venta

POST

/bindentidad-transaction-v2/v2/api/v1.201/orden-venta-pendiente

Crea una orden de venta asociada a la caja indicada.

Una orden de venta indica información específica que la billetera que lee el QR deberá considerar para poder instruir el pago.

Sólo puede existir una orden de venta pendiente en una caja. Si existe una orden de venta pendiente y se crea una nueva, la billetera al leer el QR verá la última creada.

Sólo puede existir una orden de venta con código externo en estado APROBADA

Request

codigoExterno string
—
OPCIONAL
Código externo de la entidad a asociar a la orden de venta.

codigoCaja string
—
OPCIONAL
Es el código de la caja en la cual se quiere crear la orden de venta.

codigoExternoCaja string
—
OPCIONAL
Es el código externo de la caja en la cual se quiere crear la orden de venta.

fechaNegocio datetime
—
REQUERIDO
Fecha y hora en que se crea la orden de venta.

montoTotal decimal
—
REQUERIDO
Es el importe total a cobrar en el QR con la orden de venta.

moneda string
—
REQUERIDO
Es la moneda de la orden de venta.
Valores posibles: "ARS"

tiempoExpiracion int
—
OPTIONAL
Es el tiempo de expiración de la orden de venta en segundos. Una vez cumplido el tiempo de expiración, la orden de venta pasará a vencida y no podrá ser pagada.
Valores posibles: 0 (valor mínimo), 10000000 (valor máximo)
Valor por defecto: 600

productos[{}] array of objects
—
OPTIONAL
Array de objetos con información sobre los ítems que incluye la orden de venta. Este dato es sólo informativo.

productos[{}].descripcion string
—
OPTIONAL
Es el nombre o denominación de un ítem de la orden de venta.

productos[{}].monto decimal
—
OPTIONAL
Es el importe del ítem de la orden de venta.

productos[{}].cantidad int
—
OPTIONAL
Cantidad del ítem.

productos[{}].codigo string
—
OPTIONAL
Código del item.

productos[{}].adicional string
—
OPTIONAL
Descripción o información adicional del item.

Response

idOrdenVenta int
Id de la orden de venta creada.

fechaExpiracion datetime
Fecha y hora en que se expirará la orden de venta. Es decir que a partir de ella, la orden de venta estará vencida y no podrá pagarse.

codigoExterno string
Código externo de la entidad.

curl request

Copy code

curl -v -X POST "https://gw-staging-qrbind.epays.services/bindentidad-transaction-v2/v2/api/v1.201/orden-venta-pendiente" -H "Content-Type: application/json" -H "Authorization: Bearer {{access_token}}" --data-raw "{
    \"codigoExterno\": \"ABC123456789\",
    \"codigoCaja\": \"B00000455196\",
    \"codigoExternoCaja\": null,
    \"fechaNegocio\": \"2023-11-21\",
    \"montoTotal\": 100.79,
    \"moneda\": \"ARS\",
    \"tiempoExpiracion\": 120,
    \"productos\": null
}
"

HTTP 201

Creación exitosa

HTTP 500

Caja inválida

HTTP 400

Falta algún campo requerido

HTTP 400

Monto inválido

HTTP 401

Token de autenticación inválido