# Treggo

# 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 (Treggo). Campo obligatorio.
USER: (Tipo de dato: string). Usuario registrado. Campo obligatorio.
API_SECRET: (Tipo de dato: string).Contraseña asociada al usuario . Campo obligatorio.

# shippment_data

origen.postal.codigoPostal: (Tipo de dato: string). 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.dpto: (Tipo de dato: string). Campo obligatorio.
origen.postal.pais: (Tipo de dato: string). Nombre del país de origen. Valores posible: Argentina, Uruguay, Mexico, Colombia, Brasil, España. Campo obligatorio.
destino.postal.codigoPostal: (Tipo de dato: string). Campo obligatorio.
destino.postal.localidad: (Tipo de dato: string). Nombre de la localidad. 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). Nombre y apellido del remitente. Campo obligatorio.
remitente.email: (Tipo de dato: string). Campo obligatorio.
remitente.telefonos: (Tipo de dato: string). Campo obligatorio.
destinatario.nombreCompleto: (Tipo de dato: string). Nombre y apellido del remitente. Campo obligatorio.
destinatario.email: (Tipo de dato: string). Campo obligatorio.
destinatario.telefonos: (Tipo de dato: string). Campo obligatorio.
bultos.idCliente: (Tipo de dato: string). Identificador del envío. Puede ser cualquiera, número de orden, por ejemplo. Campo obligatorio.

{
    "provider_data": {
        "provider": "Treggo",
        "USER": "benito@pow.la",
        "API_SECRET": "41144a4c-fc55-40d9-869e-667c13c1d5df", 
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1191",
                "calle": "Calle 7",
                "numero": "120",
                "piso": "2",
                "departamento": "C",
                "localidad": "Almagro",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "",
        "tipo_paquete": "",
        "id_externo": "",  
        "modalidad_envio": "",
                                                                                    
        "direccion_envio": "", 
                                                                          
        "correo": "",
        "currency": "2", 
        "type": "1",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigoPostal": "1425",
                "calle": "calle 45",
                "numero": "1756",
                "piso": "2",
                "departamento": "C",
                "localidad": "Palermo",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Alberto Lopez",
            "email": "remitente@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "113332244"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "email": "destinatario@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "",
        "bultos": {
            "kilos": "",
            "largoCm": "",
            "altoCm": "",
            "anchoCm": "",
            "volumenCm": "",
            "valorDeclaradoSinImpuestos": "",
            "valorDeclaradoConImpuestos": "",
            "detalle": "",
            "idCliente": "RMA 12341"
        }
    }
}

RESPONSE

numeroDeEnvio: número de envío generado por Treggo.

{
    "response": "Success",
    "providerStatus": "Creado",
    "numeroDeEnvio": "53e6207d-09f9-4fb6-81a6-74dad342528b",
    "hash": null,
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": ""
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": null,
    "etiqueta": ""
}

# 2. Imprimir etiqueta

GET /api/shipping/etiqueta/:id

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

REQUEST

id: Número de envío. Va en el id de la url como ruta parametrizada. Campo obligatorio.

Este campo van en el header:

provider: Treggo. Campo obligatorio.
USER: Usuario registrado. Campo obligatorio.
COUNTRY: Nombre del país de origen. Valores posible: Argentina, Uruguay, Mexico, Colombia, Brasil, España. Campo obligatorio.. Campo obligatorio.
APISECRET:Contraseña asociada al usuario . Campo obligatorio.

provider: Treggo
USER: benito@pow.la
APISECRET: 41144a4c-fc55-40d9-869e-667c13c1d5df
COUNTRY: ARGENTINA

RESPONSE

Devuelve una etiqueta en formato pdf.

# 3. Obtener tracking (Estado de envío)

GET /api/shipping/:id

Permite obtener el estado de un envío.

REQUEST

id: Número de envío. Va en el id de la url como ruta parametrizada. Campo obligatorio.

Este campo van en el header:

provider: Treggo. Campo obligatorio.
USER: Usuario registrado. Campo obligatorio.
COUNTRY: Nombre del país de origen. Valores posible: Argentina, Uruguay, Mexico, Colombia, Brasil, España. Campo obligatorio.. Campo obligatorio.
APISECRET:Contraseña asociada al usuario . Campo obligatorio.

provider: Treggo
USER: benito@pow.la
APISECRET: 41144a4c-fc55-40d9-869e-667c13c1d5df
COUNTRY: ARGENTINA

RESPONSE

providerStatus: Estado de envío.
descripcionServicio: Tipo de servicio de envío.

{
    "response": "Success",
    "providerStatus": "Pendiente de recolección",
    "numeroDeEnvio": "53e6207d-09f9-4fb6-81a6-74dad342528b",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": null
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": "ondemand"
}