Crear una venta

POST

/store/$id/sales/$transactionId

store

Este endpoint permite registrar una nueva venta en el sistema, incluyendo todos los detalles relevantes del cliente y la operación. Es una herramienta clave para completar el flujo de ventas y garantizar que toda la información asociada quede correctamente registrada.

Request

Body Params application/json

approval_sale_code

string

required

El código que de aprobación de la venta

user_code

integer

optional

El código entregado por el Usuario

Example

{
    "approval_sale_code": "A1B2C3D4E5",
    "user_code": 7864
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/store/$id/sales/$transactionId' \
--header 'Content-Type: application/json' \
--data-raw '{
    "approval_sale_code": "A1B2C3D4E5",
    "user_code": 7864
}'

Responses

🟢201Venta creada

application/json

Body

number <int64>

required

Número de Comprobante | longitud máxima 19

Example:

12312123

created_at

string <date-time>

required

Fecha de creación de la venta

completed_at

string <date-time>

required

longitud máxima 24

Example:

2025-02-16T12:39:56Z

currency

string

required

Moneda de la venta | longitud máxima 3

Example:

CLP

base_amount

number <double>

required

Monto base de la venta | longitud máxima 15

Example:

100

tax_amount

number <double>

required

Impuesto de la venta | longitud máxima 15

Example:

tips_amount

number <double>

required

Monto equivalente a la propina

amount

number <double>

required

Monto total de la venta | longitud máxima 15

Example:

119

commission_amount

number <double>

required

Monto equivalente a la comisión

code

integer

required

Codigo interno que referencia el caso de uso de la respuesta

status

string

required

nombre del estado que identifica la respuesta

message

string

required

Mensaje descriptivo de la respuesta

Example

{
    "id": 12345,
    "created_at": "2023-04-15T10:30:22Z",
    "completed_at": "2023-04-15T10:32:45Z",
    "currency": "CLP",
    "base_amount": 8403,
    "tax_amount": 1597,
    "tips_amount": 1000,
    "amount": 11000,
    "commission_amount": 290,
    "code": 0,
    "status": "created",
    "message": "La solicitud fue procesada con éxito"
}

🟠400expired_code

🟠409invalid_code

🟠409La venta ya fue creada

🟠400Rejected

Modified at 2025-04-30 18:31:51

Anular la venta

Listar ventas por local