Subir Orden

Este endpoint permite subir órdenes al eCommerce, validar los productos a través de su SKU o ID, actualizar el stock automáticamente y almacenar la información de envío. URL

POST /api/add-order

Autenticación

Este endpoint requiere una API Key válida.

Cabecera

Content-Type: application/json

Parámetros

El cuerpo de la solicitud debe enviarse en formato JSON con los siguientes campos:

apikey	string	✅	Clave de autenticación de la API

buyer_id	int	❌	ID del comprador (si es invitado, enviar 0)

payment_method	string	✅	Método de pago (Ejemplo: "Credit Card", "PayPal")

total_amount	float	✅	Monto total del pedido

currency	string	✅	Código de la moneda en la que se realizó la compra (Ejemplo: "USD", "UYU")

products	array	✅	Lista de productos en la orden

products[].sku	string	❌	SKU del producto (si no se envía product_id, se busca por SKU)

products[].product_id	int	❌	ID del producto (si no se envía sku, se usa este ID)

products[].quantity	int	✅	Cantidad del producto

shipping	object	✅	Datos de envío

Objeto shipping

Parámetro	Tipo	Requerido	Descripción
first_name	string	✅	Nombre del destinatario
last_name	string	✅	Apellido del destinatario
email	string	✅	Correo electrónico
phone_number	string	✅	Número de teléfono
address	string	✅	Dirección de envío
city	string	✅	Ciudad
state	string	✅	Estado/Provincia
country	string	✅	País
zip_code	string	✅	Código postal

Ejemplo de Solicitud

{
    "apikey": "tu_api_key",
    "buyer_id": 123,
    "payment_method": "Credit Card",
    "total_amount": 150.75,
    "currency": "USD",
    "products": [
        {"sku": "ABC123", "quantity": 2},
        {"product_id": 5, "quantity": 1}
    ],
    "shipping": {
        "first_name": "Juan",
        "last_name": "Perez",
        "email": "[email protected]",
        "phone_number": "123456789",
        "address": "Calle Falsa 123",
        "city": "Ciudad",
        "state": "Estado",
        "country": "Pais",
        "zip_code": "00000"
    }
}

Respuesta Exitosa

{
    "success": true,
    "order_id": 10123
}

Posibles Errores

403	Invalid API Key	La API Key proporcionada no es válida.

400	Missing required fields	Faltan campos obligatorios en la solicitud.

404	Product not found	Alguno de los productos especificados no fue encontrado.