> ## Documentation Index
> Fetch the complete documentation index at: https://developers.goevery.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Pasos para crear un envío

En esta guía, te explicaremos paso a paso cómo crear un envío utilizando el API de every. Sigue estos pasos para integrar y automatizar tus envíos de manera eficiente.

### 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 envío, 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í](/api-reference/endpoint/get-v1locations).

### 3. Crear una nueva cotización

Una vez que tengas la lista de ciudades, puedes proceder a crear una cotización para el envío. Este paso te permitirá obtener una tarifa estimada para el envío basado en el origen, destino, peso, dimensiones y valor declarado del paquete.

<Note>El proceso de cotización en every es asíncrono. Una vez que creas una cotización, esta generará una lista de ofertas de cada empresa transportadora en estado `PENDING`. Deberás consultar periódicamente la cotización hasta que la oferta que te interese pase a estado `SUCCESS` o `FAILED`. En el caso de que pase a `SUCCESS`, ya puedes obtener los valores de la cotización.</Note>

Este es un ejemplo de la petición que debes enviar al [endpoint](/api-reference/endpoint/post-v1quotes) de creación de cotización. En este ejemplo el valor declarado del paquete es **COP 45.000** y se van a recaudar **COP 89.000** contra entrega.

```json theme={null}
{
  "origin": "locations/CO-05001000",
  "destination": "locations/CO-11001000",
  "package": {
      "declaredValueCents": 4500000,
      "dimensions": {
          "lengthCm": 10,
          "widthCm": 20,
          "heightCm": 15
      },
      "weightKg": 2,
      "contentDescription": "Shoes"
  },
  "cashOnDeliveryRequestCents": 8900000
}
```

<Tip>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.</Tip>

Para crear una cotización debes usar este [endpoint](/api-reference/endpoint/post-v1quotes) y luego para consultarla hasta que la oferta que te interese haya sido completada, debes usar este [endpoint](/api-reference/endpoint/get-v1quotes).

### 4. Consultar la lista de orígenes

En every, un origen se refiere al lugar desde donde se envían los paquetes y al cual se retornarán en caso de devolución. Este puede ser, por ejemplo, tu tienda o almacén principal.

Antes de poder realizar envíos, es necesario que tengas al menos un origen. Para crear tu primer origen, comunícate con tu asesor de every.

Para saber desde dónde puedes despachar tus envíos, necesitas consultar la lista de orígenes disponibles. Esto te ayudará a seleccionar el punto de partida más adecuado para tu envío.

Encuentra la documentación del endpoint [aquí](/api-reference/endpoint/get-v1origins).

### 5. Crear un envío

Con la cotización y el origen ya definidos, puedes crear un envío. En este paso, deberás especificar la cotización obtenida y el origen desde donde se va a enviar, junto con los detalles del destinatario y del paquete.

<Note>El proceso de creación de envíos en every también es asíncrono. Cuando un envío es creado, iniciará en estado `GENERATING_LABEL`. Luego, pasará a estado `LABEL_GENERATED` si no se solicitó una recogida, a `SCHEDULED_PICKUP` si se solicitó una recogida, o a `WITH_ERROR` si ocurrió un error generando la guía.</Note>

Encuentra la documentación del endpoint [aquí](/api-reference/endpoint/post-v1shipments).

### 6. Consultar el envío creado

Finalmente, para verificar los detalles del envío y obtener la guía, puedes consultar el envío creado. Este paso te permitirá obtener toda la información necesaria para el seguimiento del envío.

Encuentra la documentación del endpoint [aquí](/api-reference/endpoint/get-v1shipments).

### Soporte

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