# Pickit

POST /api/shipping/create

A través de este método se genera el envío a un punto de recolección para ser retirado por un cliente.

• provider: (Tipo de dato: string). Nombre del OOLL (Treggo). Campo obligatorio.

• token: (Tipo de dato: string). Usuario registrado. Campo obligatorio.

• apiKey: (Tipo de dato: string). Contraseña asociada al usuario . Campo obligatorio.

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

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

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

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

• destino.postal.codigoPostal: (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.localidad: (Tipo de dato: string). Campo obligatorio.

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

• destino.sucursal.id: (Tipo de dato: string). Id del punto pickit. Campo obligatorio.

• bultos.idCliente:(Tipo de dato: string). Observaciones adicionales sobre la transacción. Campo optativo.

• tipo_servicio: (Tipo de dato: string) Para envío convencional el valor es "dispatch", para same day "sameDay", para drop off market place "dropoffmk",y para devoluciones "refund". En caso de no enviar valor toma por defecto "dispatch".

• tipo_estado: (Tipo de dato: string) En caso de devoluciones a punto pickit este campo deberá ir en con el valor "4" (tmb deberá tener completo el campo destino.sucursal.id). Para devoluciones a domicilio deberá ir el valor "5"

• modalidad_envio: (Tipo de dato: string) Tipo de servicio. Para envíos same day el valor es "SM", para drop off market place "DOM" y para envío a domicilio convencional "PP". En caso de no enviar un valor toma por defecto "PP". Campo obligatorio para same day y drop off.

• tipo_envio: (Tipo de dato: string) En caso de devoluciones a punto pickit el valor deberá ser "1", para para envíos a domiciolio (convencional, same day o devoluciones) el valor es "2", para drop off market place el valor es "3". En caso de no enviar un valor tomará por defecto "1".

• fecha_inicio_retiro: (Tipo de dato: string) En caso de retiro a domicilio se deberá indicar este campo incluyendo el rango de hora y fecha para el retiro de la devolución, la cual debe ser mayor o igual a 4 días hábiles a partir de la creación de la transacción. Se trata del límite inferior del período para retiro y el formato deber ser "2024-08-06T12:00:00907Z".

• fecha_fin_retiro: En caso de retiro a domicilio se deberá indicar este campo incluyendo el rango de hora y fecha para el retiro de la devolución, la cual debe ser mayor o igual a 4 días hábiles a partir de la creación de la transacción. Se trata del límite superior del período para retiro y el formato deber ser "2024-08-06T12:00:00907Z".

REQUEST

{
    "provider_data": {
        "provider": "Pickit",
        "token": "8ZQE56R7YK",
        "apiKey": "WOR3BLGRPM" 
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1414",
                "calle": "Thames",
                "numero": "1600",
                "piso": "2",
                "departamento": "C",
                "localidad": "Palermo",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "",
        "tipo_paquete": "",
        "id_externo": "",  
        "modalidad_envio": "",
        "direccion_envio": "", 
        "fecha_inicio_retiro": "",
        "fecha_fin_retiro": "",                        
        "correo": "",
        "currency": "2", 
        "type": "1",
        "destino": {
            "sucursal": {
                "id": "2"
            },
            "postal": {
                "codigoPostal": "1418",
                "calle": "Miñones",
                "numero": "2177",
                "piso": "2",
                "departamento": "C",
                "localidad": "Belgrano",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Alberto Lopez",
            "email": "remitente@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "29946689",
            "telefonos": "113332244"
        },
        "destinatario": {
            "nombreCompleto": "",
            "nombre": "Juana",
            "apellido": "González",
            "email": "destinatario@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "29946689",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "",
        "bultos": {
            "kilos": "",
            "largoCm": "",
            "altoCm": "",
            "anchoCm": "",
            "volumenCm": "",
            "valorDeclaradoSinImpuestos": "",
            "valorDeclaradoConImpuestos": "",
            "detalle": "",
            "idCliente": "PRODUCTO"
        }
    }
}

RESPONSE

• transactionId: Identificador de la transacción (se usa para consultar la etiqueta).

• numeroDeEnvio: Nro de seguimiento pickit.

{
    "response": "Success",
    "providerStatus": "Creado",
    "numeroDeEnvio": "8QX5Y6V4",
    "transactionId": 38925173,
    "hash": null,
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": ""
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": null,
    "etiqueta": ""
}

GET /api/shipping/etiqueta/:id

Permite obtener la url de la etiqueta del envío.

REQUEST

• id: Número de envío. Va en el id de la url como ruta parametrizada. Es el "transactionId" obtenido al general el envío. Campo obligatorio.

Este campo van en el header:

• provider: Pickit. Campo obligatorio.

• token: Token provisto por Pickit. Campo obligatorio.

• apikey: Contraseña provista por Pickit. Campo obligatorio.

provider: Pickit
token: 8ZQE56R7YK
apikey: WOR3BLGRPM

RESPONSE

Devuelve la etiqueta en formato url.