Crear un nuevo envío

Registra un nuevo envío en el sistema y retorna el número de guía generado.

POST /envios v1.0.0
Autenticación
API Key
Ambiente
Servidor principal

Descripción

Registra un nuevo envío en el sistema y retorna el número de guía generado.

Quick Start

  1. Obtén tus credenciales de acceso (API Key).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

POST /envios

Base URL https://api.coordinadora.com/v1

Parámetros

Sin parámetros declarados.

Body *

{
    "$ref": "#/components/schemas/EnvioRequest"
}

Ejemplo de request

{
    "remitente": {
        "nombre": "Empresa ABC",
        "direccion": "Calle 10 # 20-30",
        "ciudad": "BOG",
        "telefono": "3001234567"
    },
    "destinatario": {
        "nombre": "Juan Pérez",
        "direccion": "Carrera 5 # 15-20",
        "ciudad": "MED",
        "telefono": "3109876543"
    },
    "paquete": {
        "peso": 2.5,
        "largo": 30,
        "ancho": 20,
        "alto": 15,
        "valor_declarado": 150000
    }
}

Respuesta

201
Envío creado exitosamente
{
    "numero_guia": "CO2026052600001",
    "estado": "RECIBIDO",
    "fecha_estimada_entrega": "2026-05-28",
    "valor_flete": 18500
}

Ejemplo de respuesta

201 Envío creado exitosamente
{
    "numero_guia": "CO2026052600001",
    "estado": "RECIBIDO",
    "fecha_estimada_entrega": "2026-05-28",
    "valor_flete": 18500
}

Errores

400
Solicitud inválida
[]
401
No autorizado
[]