# Coordinadora

# 1. Generar envío

POST /api/shipping/create

El método permite generar un envío.

REQUEST

# provider_data
  • provider: (Tipo de dato: string). Nombre del OOLL (Coordinadora). Campo obligatorio.

  • USER: (Tipo de dato: string). Nombre de usuario. Campo obligatorio.

  • PASS: (Tipo de dato: string). Contraseña. Campo obligatorio.

# shippment_data
  • origen.postal.codigo_ciudad: (Tipo de dato: string). Código DANE de la ciudad de origen. Agregar 3 ceros más al final (Ej: 11001 = 11001000 ). Campo obligatorio.

  • destino.postal.codigo_ciudad: (Tipo de dato: string). Código DANE de la ciudad de destino. Agregar 3 ceros más al final (Ej: 11001 = 11001000 ). Campo obligatorio.

  • origen.postal.calle: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.numero:(Tipo de dato: string). Campo obligatorio.

  • origen.postal.piso: (Tipo de dato: string). Campo obligatorio.

  • origen.postal.depto: (Tipo de dato: string). Campo obligatorio.

  • destino.postal.calle: (Tipo de dato: string). Campo obligatorio.

  • destino.postal.numero:(Tipo de dato: string). Campo obligatorio.

  • destino.postal.piso: (Tipo de dato: string). Campo obligatorio.

  • destino.postal.depto: (Tipo de dato: string). Campo obligatorio.

  • remitente.nombreCompleto: (Tipo de dato: string). Campo obligatorio.

  • remitente.email:(Tipo de dato: string). Campo obligatorio.

  • remitente.telefonos: (Tipo de dato: string). Campo obligatorio.

  • destinatario.nombreCompleto: (Tipo de dato: string). Campo obligatorio.

  • destinatario.email: (Tipo de dato: string). Campo obligatorio.

  • destinatario.telefonos: (Tipo de dato: string). Campo obligatorio.

  • bultos.valorDeclaradoConImpuestos: (Tipo de dato: string). Valor declarado del paquete. Campo obligatorio.

  • bultos.kilo: (Tipo de dato: integer). Peso del paquete en kilogramos, separado por punto. Campo obligatorio.

  • bultos.largoCm:(Tipo de dato: integer). Largo del paquete en centímetros. Campo obligatorio.

  • bultos.altoCm: (Tipo de dato: integer). Alto del paquete en centímetros. Campo obligatorio.

  • bultos.anchoCm: (Tipo de dato: float). Ancho del paquete en centímetros. Campo obligatorio.

  • bultos.idCliente: (Tipo de dato: string). Id del cliente provisto por Coordinadora. Campo obligatorio

{
    "provider_data": {
        "provider": "Coordinadora",
        "USER": "pruebas.pow", 
        "PASS": "53df2fcd8b6b9b3bfd99ee2a45baf4e79785b89c68060a70ffb3d6ccbc8cb0cf"   
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigo_ciudad": "11001000",
                "calle": "Calle 7",
                "numero": "120",
                "piso": "2",
                "depto": "C",
                "localidad": "",
                "region": "",
                "pais": "",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "",
        "tipo_paquete": "",
        "id_externo": "",  
        "modalidad_envio": "",
                                                                                    
        "direccion_envio": "", 
                                                                          
        "correo": "",
        "currency": "", 
        "type": "",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigo_ciudad": "11001000",
                "calle": "calle 45",
                "numero": "1756",
                "piso": "2",
                "depto": "C",
                "localidad": "",
                "region": "",
                "pais": "",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Alberto Lopez",
            "email": "remitente@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "113332244"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "email": "destinatario@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "33999888",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "",
        "bultos": {
            "kilos": 2.5,
            "largoCm": 10,
            "altoCm": 50,
            "anchoCm": 10,
            "volumenCm": "",
            "valorDeclaradoSinImpuestos": 6000,
            "valorDeclaradoConImpuestos": ",
            "detalle": "",
            "idCliente": "26200"
        }
    }
}

RESPONSE

  • codigo_remision: Código de remisión asignado a la guia. Símil número de envío.

  • pdf_guia: Cadena binaria de un archivo pdf codificado en base64.

{
    "id_remision":"7246006",
    "codigo_remision":"73940576679",
    "pdf_guia":"",
    "url_terceros":"http://sandbox.coordinadora.com/vmi/?guia=73940576679-533cf2d7606b26e043ebff3972ba438c76f127edd8580a0f406da195e39b30dc",
    "referencia":"1111111"}

# 2. Imprimir etiqueta

GET /api/shipping/etiqueta/:id

Permite obtener la etiqueta del envío en formato pdf.

REQUEST

  • id: Código de remisión. Va en el id de la url como ruta parametrizada. Campo obligatorio.

Este campo van en el header:

  • provider: Coordinadora. Campo obligatorio.

RESPONSE

Devuelve el pdf de la etiqueta.

# 3. Estado de envío

GET /api/shipping/:id

Permite obtener el estado de un envío.

REQUEST

  • id: Código de remisión. Va en el id de la url como ruta parametrizada. Campo obligatorio.

Este campo van en el header:

  • provider: Coordinadora. Campo obligatorio.
  • user: Usuario. Campo obligatorio.
  • pass: Contraseña. Campo obligatorio.
provider: Coordinadora
user:  pruebas.pow
pass: 53df2fcd8b6b9b3bfd99ee2a45baf4e79785b89c68060a70ffb3d6ccbc8cb0cf

RESPONSE

  • providerStatus: Devuelve el status del envío.
{
    "response": "Success",
    "providerStatus": "ENTREGADA",
    "numeroDeEnvio": "73940620934",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": null
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "etiqueta": ""
}