# FastTrack

# 1. Cotizar envío

POST /api/shipping/price

Devuelve un array con los servicios disponibles.

REQUEST

# provider_data

provider: (Tipo de dato: string). Nombre del OOLL (FastTrack). Campo obligatorio.
API_KEY: (Tipo de dato: string). Api token provisto por FastTrack. Campo obligatorio.
CODIGO_SUCURSAL: (Tipo de dato: string). Código de sucursal. Campo obligatorio.
CODIGO_CLIENTE: (Tipo de dato: string). Tipo de servicio. Campo obligatorio.

# shippment_data

destino.postal.codigoPostal: (Tipo de dato: string). Código postal de destino. Campo obligatorio
bultos.kilos: (Tipo de dato: float). Peso del paquete en kilogramos, separado por punto. Campo obligatorio
bultos.largoCm: (Tipo de dato: float). Largo del paquete en metros. El separador de decimales deber ser un punto. Campo obligatorio
bultos.anchoCm:(Tipo de dato: float). Ancho del paquete en metros. El separador de decimales deber ser un punto. Campo obligatorio
bultos.altoCm: (Tipo de dato: float). Alto del paquete en metros. El separador de decimales deber ser un punto. Campo obligatorio
bultos.detalle: (Tipo de dato: string). Detalle del producto. Campo obligatorio

{
    "provider_data": {
        "provider": "FastTrack",
        "API_KEY": "", 
        "CONTRATO_SUCURSAL": "25670-9999", 
        "CODIGO_CLIENTE": "004"
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": ""
            }
        },
        "destino":{
            "postal": {
                "codigoPostal": "1191"
            }
        },
        "id_externo": "",
        "fecha_alta": "",
        "modalidad_envio":"",
        "currency": "",
        "type": "",
        "productoAEntregar": "",
        "bultos": {
            "kilos": 1,
            "largoCm": 0.25,
            "altoCm": 0.25,
            "anchoCm": 0.25,
            "cantidad": 1,
            "detalle": "producto"
        }
    }
}

RESPONSE

costo: Costo del envío.

{
     "costo": 4894.05
}

# 2. Generar Envío / Retiro (Log. Inv.)

POST /api/shipping/create

El método permite generar un envío.

REQUEST

# provider_data

provider: (Tipo de dato: string). Nombre del OOLL (FastTrack). Campo obligatorio.
API_KEY: (Tipo de dato: string). Api token provisto por FastTrack. Campo obligatorio.
CODIGO_SUCURSAL: (Tipo de dato: string). Código de sucursal. Campo obligatorio.
CODIGO_CLIENTE: (Tipo de dato: string). Tipo de servicio. Campo obligatorio.

# shippment_data

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 opcional.
destino.postal.departamento:(Tipo de dato: string). Campo opcional.
destino.postal.localidad: (Tipo de dato: string). Nombre de la ciudad de destino (Ej: Olivos). Campo obligatorio.
destino.postal.region: (Tipo de dato: string). Provincia a la cual pertenece la ciudad de destino (Ej: Buenos Aires). Campo obligatorio.
destino.postal.codigoPostal: (Tipo de dato: string). Código Postal de la ciudad de destino. Campo obligatorio.
destinatario.nombreCompleto: (Tipo de dato: string). Campo obligatorio.
destinatario.documentoNumero: (Tipo de dato: string). Campo obligatorio.
destinatario.email:(Tipo de dato: string). Campo obligatorio.
destinatario.telefonos: (Tipo de dato: string). Campo obligatorio.
id_externo: (Tipo de dato: string). Número de orden asociado al envío. No puede repetirse. Campo obligatorio.
type: (Tipo de dato: string). Indica si se trata de envío convencional o logística inversa. En caso de logística inversa enviar el valor "return". Campo obligatorio en logística inversa.
modalidad_envio: (Tipo de dato: string). Indica si el envío es urgente o no. Campo obligatorio.
fecha_alta: (Tipo de dato: string). Indica la franja del día en que se visitará al cliente para el retiro. Campo obligatorio solo para retiros.
tipoServicio: (Tipo de dato: string) Tipo de servicio. Campo obligatorio. Opciones:
- ENTREGA : entrega
- RETIRO : retiro
- ENTREGA Y RETIRO : Cambio mano a mano
- ENTREGA BOLSIN
- RETIROBOLSIN
bultos.kilos: (Tipo de dato: float). Peso en kilos. obligatorio.
bultos.largoCm: (Tipo de dato: float). En metros. Campo opcional.
bultos.altoCm: (Tipo de dato: string). En metros. Campo opcional.
bultos.anchoCm: (Tipo de dato: string). En metros. Campo opcional.
bultos.valorDeclaradoConImpuestos: (Tipo de dato: string). Campo Obligatorio.
bultos.detalle: (Tipo de dato: string). Descripción del producto Campo Obligatorio.
bultos.cantidad: (Tipo de dato: string). Campo Obligatorio.

Nota: Para logística inversa de debe utilizar retiro (R).

{
    "provider_data": {
        "provider": "FastTrack",
        "API_KEY": ""
        "CONTRATO_SUCURSAL": "25670-9999", 
        "CODIGO_CLIENTE": "004", 
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1407",
                "calle": "Cortina",
                "numero": "120",
                "piso": "2",
                "departamento": "C",
                "localidad": "CABA",
                "region": "Buenos Aires",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "RETIRO",
        "tipo_paquete": "",
        "id_externo": "435678151",
        "modalidad_envio": "false",                  
        "direccion_envio": "",                                                               
        "correo": "", 
        "currency": "", 
        "type": "", 
        "flow": "",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigoPostal": "1025",
                "calle": "Av Callao",
                "numero": "1756",
                "piso": "2",
                "departamento": "C",
                "localidad": "CABA",
                "region": "Buenos Aires",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Alberto Lopez",
            "email": "remitente@andreani.com",
            "documentoTipo": "DNI",
            "documentoNumero": "33111222",
            "telefonos": "113332244"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "email": "destinatario@andreani.com",
            "documentoTipo": "DNI",
            "documentoNumero": "33999888",
            "telefonos": "1112345678"
        },
        "bultos": {
            "kilos": 2,
            "largoCm": 0.25,
            "altoCm": 0.25,
            "anchoCm": 0.25,
            "volumenCm": "",
            "valorDeclaradoConImpuestos": 1452,
            "detalle": "Secador de pelo",
            "idCliente": "",
            "cantidad": 1
        }
    }
}

RESPONSE

numeroDeEnvio: Número de guía. Se utiliza para la obtención de etiqueta y el tracking (Estado de envío).
statusRetiro: Devuelve el status y número de retiro en formato string. Solo se observa en retiros.

{
    response: "Success",
    providerStatus: "Creado",
    numeroDeEnvio: "103610465",
    statusRetiro: "Retiro guardado Correctamente. Fecha de Retiro: 06/01/2022  Nro Retiro: 212286",
    sucursalDeDistribucion: {
    id: null,
    descripcion: "",
    },
    sucursalDeRendicion: null,
    sucursalDeImposicion: null,
    numeroDePermisionaria: null,
    descripcionServicio: "",
    etiqueta: ""
}

# 3. Obtener etiqueta

GET /api/shipping/etiqueta/:id

Se emplea para rastrear obtener la url de la etiqueta.

REQUEST

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

Todos estos campos van en el header:

provider: Nombre del OOLL (FastTrack). Campo obligatorio.
APIKEY: (Tipo de dato: string). Api token provisto por FastTrack. Campo obligatorio.

provider: FastTrack
APIKEY: 

RESPONSE

Devuelve la etiqueta en formato pdf 10x15.

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

GET /api/shipping/:id

Se emplea para rastrear el envío y obtener su status.

REQUEST

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

Todos estos campos van en el header:

provider: Nombre del OOLL (FastTrack). Campo obligatorio.
APIKEY: (Tipo de dato: string). Api token provisto por FastTrack. Campo obligatorio.

provider: FastTrack
APIKEY: 

RESPONSE

providerStatus: Código del estado del envío. Valores posibles:

{
    "response": "Success",
    "providerStatus": "Guía Emitida",
    "numeroDeEnvio": "103640417",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": null
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": ""
}