Create Sale

curl --request POST \
  --url https://api.example.com/api/sales \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": {},
      "quantity": 123
    }
  ],
  "subtotal": 123,
  "tipoEntrega": "<string>",
  "medioPago": "<string>",
  "cpDestino": "<string>",
  "direccionEnvio": "<string>",
  "ciudadEnvio": "<string>",
  "provinciaEnvio": "<string>",
  "telefonoEnvio": "<string>",
  "documentoEnvio": "<string>"
}
'

import requests

url = "https://api.example.com/api/sales"

payload = {
    "items": [
        {
            "id": {},
            "quantity": 123
        }
    ],
    "subtotal": 123,
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "cpDestino": "<string>",
    "direccionEnvio": "<string>",
    "ciudadEnvio": "<string>",
    "provinciaEnvio": "<string>",
    "telefonoEnvio": "<string>",
    "documentoEnvio": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [{id: {}, quantity: 123}],
    subtotal: 123,
    tipoEntrega: '<string>',
    medioPago: '<string>',
    cpDestino: '<string>',
    direccionEnvio: '<string>',
    ciudadEnvio: '<string>',
    provinciaEnvio: '<string>',
    telefonoEnvio: '<string>',
    documentoEnvio: '<string>'
  })
};

fetch('https://api.example.com/api/sales', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/sales",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'items' => [
        [
                'id' => [
                                
                ],
                'quantity' => 123
        ]
    ],
    'subtotal' => 123,
    'tipoEntrega' => '<string>',
    'medioPago' => '<string>',
    'cpDestino' => '<string>',
    'direccionEnvio' => '<string>',
    'ciudadEnvio' => '<string>',
    'provinciaEnvio' => '<string>',
    'telefonoEnvio' => '<string>',
    'documentoEnvio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/sales"

	payload := strings.NewReader("{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/sales")
  .header("Content-Type", "application/json")
  .body("{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/sales")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": 123,
    "fecha": "<string>",
    "montoTotal": 123,
    "estado": "<string>",
    "costoEnvio": 123,
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "clienteId": 123,
    "lineasVenta": [
      {}
    ]
  },
  "error": "<string>",
  "details": [
    {}
  ]
}

POST

api

sales

Create Sale

curl --request POST \
  --url https://api.example.com/api/sales \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": {},
      "quantity": 123
    }
  ],
  "subtotal": 123,
  "tipoEntrega": "<string>",
  "medioPago": "<string>",
  "cpDestino": "<string>",
  "direccionEnvio": "<string>",
  "ciudadEnvio": "<string>",
  "provinciaEnvio": "<string>",
  "telefonoEnvio": "<string>",
  "documentoEnvio": "<string>"
}
'

import requests

url = "https://api.example.com/api/sales"

payload = {
    "items": [
        {
            "id": {},
            "quantity": 123
        }
    ],
    "subtotal": 123,
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "cpDestino": "<string>",
    "direccionEnvio": "<string>",
    "ciudadEnvio": "<string>",
    "provinciaEnvio": "<string>",
    "telefonoEnvio": "<string>",
    "documentoEnvio": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [{id: {}, quantity: 123}],
    subtotal: 123,
    tipoEntrega: '<string>',
    medioPago: '<string>',
    cpDestino: '<string>',
    direccionEnvio: '<string>',
    ciudadEnvio: '<string>',
    provinciaEnvio: '<string>',
    telefonoEnvio: '<string>',
    documentoEnvio: '<string>'
  })
};

fetch('https://api.example.com/api/sales', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/sales",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'items' => [
        [
                'id' => [
                                
                ],
                'quantity' => 123
        ]
    ],
    'subtotal' => 123,
    'tipoEntrega' => '<string>',
    'medioPago' => '<string>',
    'cpDestino' => '<string>',
    'direccionEnvio' => '<string>',
    'ciudadEnvio' => '<string>',
    'provinciaEnvio' => '<string>',
    'telefonoEnvio' => '<string>',
    'documentoEnvio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/sales"

	payload := strings.NewReader("{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/sales")
  .header("Content-Type", "application/json")
  .body("{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/sales")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"items\": [\n    {\n      \"id\": {},\n      \"quantity\": 123\n    }\n  ],\n  \"subtotal\": 123,\n  \"tipoEntrega\": \"<string>\",\n  \"medioPago\": \"<string>\",\n  \"cpDestino\": \"<string>\",\n  \"direccionEnvio\": \"<string>\",\n  \"ciudadEnvio\": \"<string>\",\n  \"provinciaEnvio\": \"<string>\",\n  \"telefonoEnvio\": \"<string>\",\n  \"documentoEnvio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": 123,
    "fecha": "<string>",
    "montoTotal": 123,
    "estado": "<string>",
    "costoEnvio": 123,
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "clienteId": 123,
    "lineasVenta": [
      {}
    ]
  },
  "error": "<string>",
  "details": [
    {}
  ]
}

Authentication

This endpoint requires authentication. Include the JWT token in the Authorization header.

Request Body

array

required

Array of items to purchase. Each item must contain:

string | number

required

Product ID

number

required

Quantity to purchase (minimum: 1)

number

required

Subtotal amount (minimum: 0)

string

required

Delivery type. Must be one of:

ENVIO - Shipping
RETIRO - Pickup at store

string

required

Payment method. Must be one of:

MERCADOPAGO - MercadoPago payment gateway
EFECTIVO - Cash payment
VIUMI - Viumi payment
TRANSFERENCIA - Bank transfer
BINANCE - Binance cryptocurrency payment

string

Destination postal code (minimum 4 characters). Required if tipoEntrega is ENVIO.

string

Shipping address. Required if tipoEntrega is ENVIO.

string

Shipping city. Required if tipoEntrega is ENVIO.

string

Shipping province. Required if tipoEntrega is ENVIO.

string

Shipping phone number. Required if tipoEntrega is ENVIO.

string

Recipient’s ID document (DNI). Required for shipping services.

Response

boolean

Indicates if the request was successful

object

The created sale object

number

Sale ID

string

Sale creation date (ISO 8601 timestamp)

number

Total sale amount including shipping

string

Sale status. One of: PENDIENTE_PAGO, PENDIENTE_APROBACION, APROBADO, ENVIADO, ENTREGADO, RECHAZADO, CANCELADO

number

Shipping cost

string

Delivery type: ENVIO or RETIRO

string

Payment method selected

number

Customer ID

array

Array of sale line items

string

Error message if the request failed

array

Validation error details (if validation failed)

Example Request

{
  "items": [
    {
      "id": 123,
      "quantity": 2
    },
    {
      "id": 456,
      "quantity": 1
    }
  ],
  "subtotal": 45000,
  "tipoEntrega": "ENVIO",
  "medioPago": "TRANSFERENCIA",
  "cpDestino": "1414",
  "direccionEnvio": "Av. Corrientes 1234",
  "ciudadEnvio": "Buenos Aires",
  "provinciaEnvio": "Capital Federal",
  "telefonoEnvio": "+5491112345678",
  "documentoEnvio": "12345678"
}

Example Response

{
  "success": true,
  "data": {
    "id": 789,
    "fecha": "2026-03-05T10:30:00.000Z",
    "montoTotal": 50000,
    "estado": "PENDIENTE_PAGO",
    "costoEnvio": 5000,
    "tipoEntrega": "ENVIO",
    "medioPago": "TRANSFERENCIA",
    "clienteId": 42,
    "direccionEnvio": "Av. Corrientes 1234",
    "ciudadEnvio": "Buenos Aires",
    "provinciaEnvio": "Capital Federal",
    "cpEnvio": "1414",
    "telefonoEnvio": "+5491112345678",
    "documentoEnvio": "12345678",
    "lineasVenta": [
      {
        "id": 1,
        "productoId": 123,
        "cantidad": 2,
        "subTotal": 30000
      },
      {
        "id": 2,
        "productoId": 456,
        "cantidad": 1,
        "subTotal": 15000
      }
    ]
  }
}

Error Responses

Validation Error (400)

{
  "success": false,
  "error": "Datos de venta inválidos",
  "details": [
    {
      "code": "invalid_type",
      "expected": "number",
      "received": "string",
      "path": ["subtotal"],
      "message": "Expected number, received string"
    }
  ]
}

Product Not Found or Insufficient Stock (400)

{
  "success": false,
  "error": "Producto no encontrado"
}

{
  "success": false,
  "error": "Stock insuficiente"
}

Unauthorized (401)

{
  "success": false,
  "error": "Unauthorized"
}

Notes

The sale is created with status PENDIENTE_PAGO by default
Stock is reserved when the sale is created
Shipping cost is automatically calculated based on the postal code for shipments
For RETIRO (pickup), no shipping information is required
The authenticated user must have an associated customer profile

⌘I

Authentication

Products

Cart & Checkout

Sales

Admin

Create Sale

Authentication

Request Body

Response

Example Request

Example Response

Error Responses

Validation Error (400)

Product Not Found or Insufficient Stock (400)

Unauthorized (401)

Notes

​Authentication

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

​Validation Error (400)

​Product Not Found or Insufficient Stock (400)

​Unauthorized (401)

​Notes

Authentication

Request Body

Response

Example Request

Example Response

Error Responses

Validation Error (400)

Product Not Found or Insufficient Stock (400)

Unauthorized (401)

Notes