# Pedidos Ya

# 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 (PedidosYa). Campo obligatorio.
API_KEY: (Tipo de dato: string). Client Id. Campo obligatorio.
API_SECRET: (Tipo de dato: string). Client secret. Campo obligatorio.
USER: (Tipo de dato: string). Usuario. Campo obligatorio.
PASS: (Tipo de dato: string). Contraseña. Campo obligatorio.

# shippment_data

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.
origen.postal.localidad: (Tipo de dato: string). Campo obligatorio.
origen.postal.latitud: (Tipo de dato: float/double) Latitud (Ejemplo: -34.6050819). Campo opcional
origen.postal.longitud: (Tipo de dato: float/double) Longitud (Ejemplo: -58.415373). Campo opcional
remitente.telefonos: (Tipo de dato: string). Campo obligatorio.
remitente.nombreCompleto: (Tipo de dato: string). Campo obligatorio.
destino.postal.latitud: (Tipo de dato: float/double) Latitud (Ejemplo: -34.6050819). Campo opcional
destino.postal.longitud: (Tipo de dato: float/double) Longitud (Ejemplo: -58.415373). Campo opcional
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.
destino.postal.localidad: (Tipo de dato: string). Campo obligatorio.
destinatario.telefonos: (Tipo de dato: string). Campo obligatorio.
destinatario.nombreCompleto: (Tipo de dato: string). Campo obligatorio.
destinatario.email: (Tipo de dato: string). Campo obligatorio.
bultos.categoria: (Tipo de dato: string). Categoría de producto según clasificación de pedidos ya. Campo opcional.
bultos.valorDeclaradoConImpuestos: (Tipo de dato: float). Precio del producto con un decimal (Ejemplo: 1599.9). Campo obligatorio.
bultos.detalle: (Tipo de dato: string). Descripción del producto. Campo obligatorio.
bultos.sku: (Tipo de dato: string). Sku del producto. Campo obligatorio.
bultos.volumenCm: (Tipo de dato: float). Volumen del producto. Enviar con dos decimales (Ejemplo: 10.01) Campo obligatorio.
bultos.kilos: (Tipo de dato: float) Peso del producto con dos decimales (Ejemplo: 5.41)

{
    "provider_data": {
        "provider": "PedidosYa",
        "API_KEY": "courier_383224_ar",
        "API_SECRET": "6e2b4aa9e8" ,
        "USER": "383224-nj09u@courierapi.com", 
        "PASS": "bt50lr72022" 
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1191",
                "calle": "Medrano",
                "numero": "700",
                "piso": "2",
                "departamento": "b",
                "localidad": "Almagro",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": "",
                "latitud": "",
                "longitud": ""

            }
        },
        "fecha_alta": "",
        "tipoServicio": "",
        "tipo_paquete": "",
        "id_externo": "",  
        "modalidad_envio": "",
                                                                                    
        "direccion_envio": "", 
                                                                          
        "correo": "",
        "currency": "2", 
        "type": "1",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigoPostal": "1828",
                "calle": "Maipú",
                "numero": "123",
                "piso": "3",
                "departamento": "a",
                "localidad": "Banfield",
                "region": "Buenos Aires",
                "pais": "Argentina",
                "entreCalle": "",
                "latitud": "",
                "longitud": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Saúl Reyes",
            "email": "saulmkt.gymco@gmail.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "113332244",
            "marca": "POW"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "nombre": "",
            "apellido": "",
            "email": "destinatario@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "",
        "bultos": {
            "kilos": 5.51,
            "largoCm": "",
            "altoCm": "",
            "anchoCm": "",
            "volumenCm": 10.01,
            "valorDeclaradoSinImpuestos": "",
            "valorDeclaradoConImpuestos": 1599.9,
            "detalle": "",
            "idCliente": "6345"
        }
    }
}

RESPONSE

numeroDeEnvio/tracking_number: Se utilizan para obtener el tracking.

{
    response: "Success",
    providerStatus: "Creado",
    numeroDeEnvio: bd520644-6878-476f-8de5-483eb1c7db14,
    confirmationCode: 123123123,
    tracking_number: bd520644-6878-476f-8de5-483eb1c7db14,
    status: "CONFIRMED",
    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 base 64.

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: Pedidos Ya. Campo obligatorio.
APIKEY: Client Id. Campo obligatorio.
APISECRET: Client secret. Campo obligatorio.
USER: Usuario. Campo obligatorio.
PASS: Contraseña. Campo obligatorio.

provider: Pedidos Ya
APIKEY: courier_364567_ar
APISECRET: 1664977745
PASS: vfexlk52022

RESPONSE

Devuelve etiqueta en formato Base 64.

{
    "proofOfDelivery": "{string_value_for_proof_of_delivery_image_base64}"
}