Solicitar una recolección

Registra una solicitud de recolección de paquetes en la dirección indicada.

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

Descripción

Registra una solicitud de recolección de paquetes en la dirección indicada.

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 /recolecciones

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

{
    "direccion": {
        "calle": "Calle 10 # 20-30",
        "ciudad": "BOG",
        "barrio": "Chapinero",
        "indicaciones": "Edificio azul, piso 3"
    },
    "contacto": {
        "nombre": "María González",
        "telefono": "3001234567"
    },
    "fecha_preferida": "2026-05-27",
    "franja_horaria": "AM",
    "cantidad_piezas": 5,
    "peso_total": 12.5
}

Respuesta

201
Recolección solicitada
{
    "id": "REC-2026-001234",
    "estado": "PROGRAMADA",
    "fecha_confirmada": "2026-05-27",
    "franja_horaria": "AM",
    "mensajero_asignado": null
}

Ejemplo de respuesta

201 Recolección solicitada 
{
    "id": "REC-2026-001234",
    "estado": "PROGRAMADA",
    "fecha_confirmada": "2026-05-27",
    "franja_horaria": "AM",
    "mensajero_asignado": null
}

Errores

400
Datos inválidos o franja no disponible
422
Ciudad no tiene cobertura de recolección