Skip to main content
En esta guía, te explicaremos paso a paso cómo crear un pedido utilizando el API de every. Un pedido te permite gestionar una compra sin tener que generar un envío de inmediato, lo que facilita el seguimiento y gestión de la orden hasta que esté lista para despacharse.

​
1. Obtener tu API key

Para utilizar el API de every, primero necesitas obtener tu clave de API (api-key). Debes solicitar esta clave a tu asesor de every. Mantén esta clave segura, ya que permite el acceso completo a tu cuenta.

​
2. Obtener la lista de ciudades

Antes de crear un pedido, necesitas conocer las ciudades que cubre every. Consulta la lista de ciudades para asegurarte de que tu destino está cubierto. Encuentra la documentación del endpoint aquí.

​
3. Crear un nuevo pedido

Una vez que tengas la lista de ciudades, puedes proceder a crear un pedido con la información del destinatario, descripción del contenido, precio de venta, y monto de recaudo contra entrega, entre otros datos. Este es un ejemplo de la petición que debes enviar al endpoint de creación de pedido. En este ejemplo, el valor de la venta es COP 85.000 y se van a recaudar COP 95.000 contra entrega. 
{
    "status": "NEW",
    "recipient": {
        "firstName": "Valentina",
        "lastName": "Rodríguez López",
        "documentType": "CC",
        "document": "1040777098",
        "email": "[email protected]",
        "phoneNumber": "+573193210329",
        "address": {
            "addressLines": [
                "Carrera 7 # 6 - 2",
                "Apto 2"
            ],
            "organization": "Happeett"
        },
        "location": "locations/CO-11001000"
    },
    "contentDescription": "Shoes",
    "notes": "1 Pair of Reebok Nano, Size 8, Color Black",
    "sellingPriceCents": 8500000,
    "cashOnDeliveryRequestCents": 9500000
}
Recuerda que los valores monetarios se especifican en centavos. Por ejemplo, para recaudar 20.000 pesos, se debe ingresar 2000000. Los valores retornados por el servicio también están en centavos.

​
4. Consultar el pedido creado

Finalmente, puedes consultar el pedido creado para obtener toda la información necesaria sobre el estado del mismo. Encuentra la documentación del endpoint aquí.

​
Soporte

Para dudas adicionales, comunícate con tu asesor de every, quien estará disponible para ayudarte con cualquier pregunta o problema que puedas tener.