# Saires

# 1. Generar envío

POST /api/shipping/create

REQUEST

# provider_data
  • provider: Saires. Campo obligatorio.

  • ID_CLIENTE: (Tipo de dato: string). Valor numérico entero identificatorio de cada cliente que deberá ser entregado manualmente por Saires. Campo obligatorio.

  • EMAIL: (Tipo de dato: string). Valor de API key único generado por medio del servicio correspondiente. 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 obligatorio.

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

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

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

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

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

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

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

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

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

  • bultos.idCliente

  • tipo_paquete:(Tipo de dato: string). Valor alfanumérico de 6 caracteres asociado al tipo de paquete a enviar. Campo obligatorio. Valores posibles a continuación:

    • LOGINV = LOGISTICA INVERSA S
    • ENECSM = SAME DAY - AMBA - S
    • ENECND = NEXT DAY - AMBA - S
    • ENECCS = CAMBIO SIMULTANEO AMBA S
    • NEXAMM = NEXT DAY - AMBA - M
    • SAMAMM = SAME DAY - AMBA - M
    • NEXAML = NEXT DAY - AMBA - L
    • SAMAML = SAME DAY - AMBA - L
    • NEXAXL = NEXT DAY - AMBA - XL
    • SAMAXL = SAME DAY - AMBA - XL
    • INVAMS = INVERSA - AMBA - S
    • REENSU = RETIRO EN SUCURSAL - S
  • modalidad_envío:(Tipo de dato: string). Valor alfanumérico de 6 caracteres asociado a la modalidad de envío. Campo opcional. Valores posibles:

    • NEXTDY = NEXT DAY
    • SAMEDY = SAME DAY
    • CAMSIM = CAMBIO SIMULTÁNEO
    • RETSUC = RETIRO EN SUCURSAL
    • INVAMS = LOGISTICA INVERSA
    • ENVMAY = MAYORISTA
    • STDARD = STANDARD
    • REENDE = RETIRO EN DEPOSITO
    • ENENDI = EN EL DIA
{
    "provider_data": {
        "provider": "Saires",
        "ID_CLIENTE": "260801",
        "EMAIL": "atc@awada.com.ar" 
    },
    "shippment_data": {
        "origen": {
            "postal": {
                "codigoPostal": "1191",
                "calle": "Medrano",
                "numero": "700",
                "piso": "2",
                "depto": "b",
                "localidad": "Almagro",
                "region": "CABA",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "fecha_alta": "",
        "tipoServicio": "",
        "tipo_paquete": "ENECSM",
        "id_externo": "",  
        "modalidad_envio": "",
        
                                                                                    
        "direccion_envio": "", 
                                                                          
        "correo": "",
        "currency": "2", 
        "type": "1",
        "destino": {
            "sucursal": {
                "id": ""
            },
            "postal": {
                "codigoPostal": "1828",
                "calle": "Maipú",
                "numero": "123",
                "piso": "3",
                "depto": "a",
                "localidad": "Banfield",
                "region": "Buenos Aires",
                "pais": "Argentina",
                "entreCalle": ""
            }
        },
        "remitente": {
            "nombreCompleto": "Juan Valdez",
            "email": "saulmkt.gymco@gmail.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "113332244",
            "marca": "POW"
        },
        "destinatario": {
            "nombreCompleto": "Juana Gonzalez",
            "nombre": "Juana",
            "apellido": "Gonzalez",
            "email": "destinatario@andreani.com",
            "documentoTipo": "",
            "documentoNumero": "",
            "telefonos": "1112345678"
        },
        "productoAEntregar": "",
        "bultos": {
            "kilos": "",
            "largoCm": "",
            "altoCm": "",
            "anchoCm": "",
            "volumenCm": "",
            "valorDeclaradoSinImpuestos": "",
            "valorDeclaradoConImpuestos": "",
            "detalle": "",
            "idCliente": "6345"
        }
    }
}

RESPONSE

  • numeroDeEnvio: se utiliza para imprimir etiqueta y obtener el tracking del envío.
{
    "response": "Success",
    "providerStatus": "Creado",
    "numeroDeEnvio": "BNH729",
    "hash": null,
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": ""
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": null,
    "etiqueta": ""
}

# 2. Obtener etiqueta

GET /api/shipping/etiqueta/:id

El método devuelve una url de la etiqueta de envío.

REQUEST

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

Todos estos campos van en el header:

  • provider: Saires.

  • Id-Cliente: Valor numérico entero identificatorio de cada cliente que deberá ser entregado manualmente por Saires.

  • Email: Valor de API key único generado por medio del servicio correspondiente.


provider: Saires
Id-Cliente: 260801
Email: atc@awada.com.ar

RESPONSE

Devuelve la url de la etiqueta.

# 3. Obtener tracking

GET /api/shipping/:id

REQUEST

Va en el header.

  • provider: Saires.

  • Id-Cliente: Valor numérico entero identificatorio de cada cliente que deberá ser entregado manualmente por Saires.

  • Email: Valor de API key único generado por medio del servicio correspondiente.


provider: Saires
Id-Cliente: 260801
Email: atc@awada.com.ar

RESPONSE

{
    "response": "Success",
    "providerStatus": "Listo para despachar",
    "numeroDeEnvio": "BNH729",
    "sucursalDeDistribucion": {
        "id": null,
        "descripcion": null
    },
    "sucursalDeRendicion": null,
    "sucursalDeImposicion": null,
    "numeroDePermisionaria": null,
    "descripcionServicio": "Estado del pedido: Listo para despachar",
    "etiqueta": ""
}