Get Sale by ID

curl --request GET \
  --url https://api.example.com/api/sales/:id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/sales/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)

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

{
  "success": true,
  "data": {
    "id": 123,
    "fecha": "<string>",
    "montoTotal": 123,
    "estado": "<string>",
    "comprobante": "<string>",
    "costoEnvio": 123,
    "metodoEnvio": "<string>",
    "codigoSeguimiento": "<string>",
    "etiquetaUrl": "<string>",
    "direccionEnvio": "<string>",
    "ciudadEnvio": "<string>",
    "provinciaEnvio": "<string>",
    "cpEnvio": "<string>",
    "telefonoEnvio": "<string>",
    "documentoEnvio": "<string>",
    "zipnovaShipmentId": "<string>",
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "clienteId": 123,
    "cliente": {},
    "lineasVenta": [
      {
        "id": 123,
        "productoId": 123,
        "cantidad": 123,
        "subTotal": 123,
        "customPrice": 123,
        "customDescription": "<string>",
        "producto": {}
      }
    ],
    "pagos": [
      {}
    ]
  },
  "error": "<string>"
}

GET

api

sales

:id

Get Sale by ID

curl --request GET \
  --url https://api.example.com/api/sales/:id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/sales/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)

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

{
  "success": true,
  "data": {
    "id": 123,
    "fecha": "<string>",
    "montoTotal": 123,
    "estado": "<string>",
    "comprobante": "<string>",
    "costoEnvio": 123,
    "metodoEnvio": "<string>",
    "codigoSeguimiento": "<string>",
    "etiquetaUrl": "<string>",
    "direccionEnvio": "<string>",
    "ciudadEnvio": "<string>",
    "provinciaEnvio": "<string>",
    "cpEnvio": "<string>",
    "telefonoEnvio": "<string>",
    "documentoEnvio": "<string>",
    "zipnovaShipmentId": "<string>",
    "tipoEntrega": "<string>",
    "medioPago": "<string>",
    "clienteId": 123,
    "cliente": {},
    "lineasVenta": [
      {
        "id": 123,
        "productoId": 123,
        "cantidad": 123,
        "subTotal": 123,
        "customPrice": 123,
        "customDescription": "<string>",
        "producto": {}
      }
    ],
    "pagos": [
      {}
    ]
  },
  "error": "<string>"
}

Authentication

This endpoint requires authentication. Users can only access their own sales unless they have admin privileges.

Path Parameters

number

required

The unique identifier of the sale

Response

boolean

Indicates if the request was successful

object

The sale object with complete details

number

Sale ID

string

Sale creation date (ISO 8601 timestamp)

number

Total sale amount including shipping

string

Current sale status:

PENDIENTE_PAGO - Pending payment
PENDIENTE_APROBACION - Pending approval
APROBADO - Approved
ENVIADO - Shipped
ENTREGADO - Delivered
RECHAZADO - Rejected
CANCELADO - Cancelled

string

Payment receipt URL (if uploaded)

number

Shipping cost

string

Shipping method (e.g., “CORREO_ARGENTINO”)

string

Tracking code for the shipment

string

Shipping label URL

string

Shipping address

string

Shipping city

string

Shipping province

string

Shipping postal code

string

Shipping phone number

string

Recipient’s ID document (DNI)

string

Zipnova shipment tracking ID

string

Delivery type: ENVIO (shipping) or RETIRO (pickup)

string

Payment method: MERCADOPAGO, EFECTIVO, VIUMI, TRANSFERENCIA, BINANCE

number

Customer ID

object

Customer information including user details

array

Array of sale line items

number

Line item ID

number

Product ID

number

Quantity purchased

number

Line item subtotal

number

Custom price (for manual sales)

string

Custom description (for manual sales)

object

Complete product information

array

Array of payment records associated with this sale

string

Error message if the request failed

Example Request

GET /api/sales/789

Example Response

{
  "success": true,
  "data": {
    "id": 789,
    "fecha": "2026-03-05T10:30:00.000Z",
    "montoTotal": 50000,
    "estado": "APROBADO",
    "comprobante": "https://storage.example.com/receipts/789.pdf",
    "costoEnvio": 5000,
    "metodoEnvio": "CORREO_ARGENTINO",
    "codigoSeguimiento": "AR123456789",
    "etiquetaUrl": "https://zipnova.com/labels/789.pdf",
    "direccionEnvio": "Av. Corrientes 1234",
    "ciudadEnvio": "Buenos Aires",
    "provinciaEnvio": "Capital Federal",
    "cpEnvio": "1414",
    "telefonoEnvio": "+5491112345678",
    "documentoEnvio": "12345678",
    "zipnovaShipmentId": "ZN789456123",
    "tipoEntrega": "ENVIO",
    "medioPago": "TRANSFERENCIA",
    "clienteId": 42,
    "cliente": {
      "id": 42,
      "userId": 100,
      "direccion": "Av. Corrientes 1234",
      "telefono": "+5491112345678",
      "user": {
        "id": 100,
        "email": "customer@example.com",
        "nombre": "Juan",
        "apellido": "Pérez",
        "telefono": "+5491112345678"
      }
    },
    "lineasVenta": [
      {
        "id": 1,
        "ventaId": 789,
        "productoId": 123,
        "cantidad": 2,
        "subTotal": 30000,
        "customPrice": null,
        "customDescription": null,
        "producto": {
          "id": 123,
          "nombre": "Procesador AMD Ryzen 5",
          "descripcion": "Procesador de 6 núcleos y 12 hilos",
          "precio": 15000,
          "stock": 8,
          "foto": "https://example.com/cpu.jpg",
          "categoriaId": 1,
          "marcaId": 2
        }
      },
      {
        "id": 2,
        "ventaId": 789,
        "productoId": 456,
        "cantidad": 1,
        "subTotal": 15000,
        "customPrice": null,
        "customDescription": null,
        "producto": {
          "id": 456,
          "nombre": "Memoria RAM 8GB DDR4",
          "descripcion": "Memoria de alto rendimiento",
          "precio": 15000,
          "stock": 15,
          "foto": "https://example.com/ram.jpg",
          "categoriaId": 3,
          "marcaId": 5
        }
      }
    ],
    "pagos": []
  }
}

Error Responses

Not Found (404)

{
  "success": false,
  "error": "Not Found"
}

Unauthorized (401)

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

Forbidden (403)

{
  "success": false,
  "error": "Access denied"
}

Notes

Users can only access their own sales unless they have admin role
The response includes complete product details for each line item
Shipping information is only populated for sales with tipoEntrega set to ENVIO
Payment receipt (comprobante) is only available if the user has uploaded one
Tracking information is populated once the order has been dispatched

⌘I

Authentication

Products

Cart & Checkout

Sales

Admin

Get Sale by ID

Authentication

Path Parameters

Response

Example Request

Example Response

Error Responses

Not Found (404)

Unauthorized (401)

Forbidden (403)

Notes

​Authentication

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

​Not Found (404)

​Unauthorized (401)

​Forbidden (403)

​Notes

Authentication

Path Parameters

Response

Example Request

Example Response

Error Responses

Not Found (404)

Unauthorized (401)

Forbidden (403)

Notes