Introduction

There are several types of webservices. Them can be used both to generate actions and to obtain information. There are some basic ones (such as the quote of the shipments, the search of branches and the creation of new shipments) and more advanced ones (like the obtaining reports). If you have doubts consult the section. Do not stop reading our Resources section to obtain extra tools.

Cómo empezar

Authentication

Authentication service...

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: login

Create a new order

Create a new order

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: ordenesDeEnvio

Body Values:
Key Type Description
destino object Destino del envío. Puede ser postal o a sucursal
destino.postal object Dirección destino del envío
destino.postal.localidad string Localidad destino del envío
destino.postal.region string Región destino del envío codificado en ISO 3166-2:AR
destino.postal.pais string País destino del envío
destino.postal.codigoPostal integer Código postal destino del envío
destino.postal.componentesDeDireccion array Dirección del envío. Es de tipo clave-valor. Las metas obligatorias son calle y numero
destino.sucursal object Sucursal destino del envío. Obligatorio en caso de entrega en sucursal.
destino.sucursal.id integer Id de la sucursal destino del envío. Se puede consulta en la API de Sucursales.
origen object Origen del envío.
origen.postal object Dirección origen del envío
origen.postal.localidad string Localidad origen del envío
origen.postal.region string Región origen del envío codificado en ISO 3166-2:AR
origen.postal.pais string País origen del envío
origen.postal.codigoPostal integer Código postal origen del envío
origen.postal.componentesDeDireccion array Dirección origen del envío. Es de tipo meta-contenido. Las metas obligatorias son calle y numero
remitente object Datos del remitente del envío.
remitente.nombres string Nombre o razón social del remitente del envío.
remitente.apellidos string Apellidos del remitente del envío.
remitente.tipoYNumeroDeDocumento string Tipo y número de documento del remitente del envío. Posibles: DNI/CUIT/CUIL XXXXXXXX
remitente.telefonos object Telefonos del remitente del envío.
remitente.telefonos.tipo integer Tipo de telefono del remitente del envío. Fax = 1, Celular =2, Fijo = 3
remitente.telefonos.numero string Numero de telefono del remitente del envío.
remitente.eMail string Correo electrónico del remitente del envío.
destinatario object Datos del destinatario del envío.
destinatario.nombres string Nombre o razón social del destinatario del envío.
destinatario.apellidos string Apellidos del destinatario del envío.
destinatario.tipoYNumeroDeDocumento string Tipo y número de documento del destinatario del envío. Posibles: DNI/CUIT/CUIL XXXXXXXX
destinatario.telefonos object Telefonos del destinatario del envío.
destinatario.telefonos.tipo integer Tipo de telefono del destinatario del envío. Fax = 1, Celular =2, Fijo = 3
destinatario.telefonos.numero string Numero de telefono del destinatario del envío.
destinatario.eMail string Correo electrónico del destinatario del envío.
contrato string Código de contrato con Andreani.
sucursalDeImposicion object Datos de la sucursal donde se llevará el envío físico. Opcional
sucursalDeImposicion.id integer Id de la sucursal de imposición. Opcional
bultosParaEnviar array Datos de cada bulto del envío. Sólo admite un bulto.
bultosParaEnviar.kilos double Peso del envío en kilos
bultosParaEnviar.valorDeclaradoConImpuestos double Valor del envío con impuestos
bultosParaEnviar.largoCm double Largo del envío en cm
bultosParaEnviar.altoCm double Alto del envío en cm
bultosParaEnviar.anchoCm double Ancho del envío en cm
referencias array Referencias del envío.Es de tipo meta-contenido. Opcional
numeroDeTracking string Numero de tracking del envío en caso de tener pre numeración. Opcional
Response:
{
  "numeroDeTracking": "300000206063720",
  "numeroDePermisionaria": "RNPSP Nº 586",
  "sucursalDeDistribucion": {
    "nomenclatura": "MRO",
    "descripcion": "MORON",
    "id": "18"
  },
  "fechaCreacion": "2018-02-08T17:34:00.6722926-03:00",
  "estado": "aceptada",
  "linking": [
    {
      "meta": "@tracking",
      "contenido": "http://tempuri.org/api/tracking/300000206063720"
    },
    {
      "meta": "@etiqueta",
      "contenido": "https://api.andreani.com/v1/etiquetas/300000206063720"
    }
  ]
}

Get a new order

Get a new order

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: ordenesDeEnvio/{numeroAndreani}

Response:
{
  "numeroDeTracking": "300000206063720",
  "linking": [
    {
      "meta": "@tracking",
      "contenido": "http://tempuri.org/api/tracking/G00000206063720"
    },
    {
      "meta": "@etiqueta",
      "contenido": "https://api.andreani.com/v1/etiquetas/G00000206063720"
    }
  ],
  "numeroDePermisionaria": "RNPSP Nº 586",
  "sucursalDeDistribucion": {
    "nomenclatura": "TEM",
    "descripcion": "TEMPERLEY",
    "id": "13"
  },
  "fechaCreacion": "2018-02-14T10:15:29.2509238-03:00",
  "estado": "creada"
}

Get the traces of a shipment

Get the traces of a shipment

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: envios/{numeroAndreani}/trazas

Response:
{
  "eventos":[{
    "Fecha":"2019-04-11T11:18:47",
    "Estado":"Pendiente de ingreso",
    "EstadoId":1,
    "Motivo":null,
    "MotivoId":0,
    "Submotivo":null,
    "SubmotivoId":0,
    "Sucursal":"",
    "SucursalId":0,
    "Ciclo":""
  },{
    "Fecha":"2019-04-13T10:05:32",
    "Estado":"Ingreso al circuito operativo",
    "EstadoId":5,
    "Motivo":null,
    "MotivoId":0,
    "Submotivo":null,
    "SubmotivoId":0,
    "Sucursal":"",
    "SucursalId":121,
    "Ciclo":""
  }
  ]
}

Get a shipment

Get a shipment

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: envios/{numeroAndreani}

Response:
{
  "numeroDeTracking": "W00000000327001",
  "contrato": "400006711",
  "estado": "Entregado",
  "sucursalDeDistribucion": {
    "nomenclatura": "SAN MARTIN",
    "descripcion": "Sucursal San Martín (Bs. As.)",
    "id": 21
  },
  "fechaCreacion": "2018-05-09T09:58:50-03:00",
  "destino": {
    "Postal": {
      "localidad": "C.A.B.A.",
      "region": "",
      "_comment": "ver /regiones para obtener los valores",
      "pais": "Argentina",
      "direccion": "Santo Domingo 3220",
      "codigoPostal": "1292"
    }
  },
  "remitente": {
    "nombreYApellido": null,
    "tipoYNumeroDeDocumento": null,
    "eMail": null
  },
  "destinatario": {
    "nombreYApellido": "Gadiel Romualdo Malagrino",
    "tipoYNumeroDeDocumento": null,
    "eMail": "prueba@gmail.com"
  },
  "bultos": [
    {
      "kilos": 0.001,
      "valorDeclaradoConImpuestos": 0,
      "IdDeProducto": "2521477863",
      "volumen": 0
    }
  ],
  "referencias": [
      "pruebas@gmail.com",
      "ID15632" 
  ]
}

Shipping tracking

Shipping tracking

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: envios

Response:
{
  envios: [
  {
    "numeroDeTracking": "W00000000327001",
    "contrato": "400006711",
    "estado": "Entregado",
    "sucursalDeDistribucion": {
      "nomenclatura": "SAN MARTIN",
      "descripcion": "Sucursal San Martín (Bs. As.)",
      "id": 21
    },
    "fechaCreacion": "2018-05-09T09:58:50-03:00",
    "destino": {
      "Postal": {
        "localidad": "C.A.B.A.",
        "region": "",
        "_comment": "ver /regiones para obtener los valores",
        "pais": "Argentina",
        "direccion": "Santo Domingo 3220",
        "codigoPostal": "1292"
      }
    },
    "remitente": {
      "nombreYApellido": null,
      "tipoYNumeroDeDocumento": null,
      "eMail": null
    },
    "destinatario": {
      "nombreYApellido": "Gadiel Romualdo Malagrino",
      "tipoYNumeroDeDocumento": null,
      "eMail": "prueba@gmail.com"
    },
    "bultos": [
      {
        "kilos": 0.001,
        "valorDeclaradoConImpuestos": 0,
        "IdDeProducto": "2521477863",  
        "volumen": 0
      }
    ],
    "referencias": [
      "pruebas@gmail.com",
      "ID15632" 
    ]
  }]
}

Get the rate of a shipment

Calculate the rate for a shipment according to the destination, weight, volume and declared value of the content.

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: tarifas

Body Values:
Key Type Description
pais string Pais destino del envío. Opcional.
cpDestino integer Codigo postal del destino del envio. Obligatorio.
contrato string Numero de contrato con Andreani. Obligatorio.
cliente string Numero de cliente con Andreani. Opcional.
sucursalOrigen string Codigo de sucursal donde se impone el envio. Opcional. En caso de no ingresarla, se toma la configurada por contrato.
bultos array Informacion de cada bulto a enviar. Obligatorio.
bultos[0][largoCm] double Largo del bulto en cm. Opcional. Sirve para calcular el volumen.
bultos[0][anchoCm] double Ancho del bulto en cm. Opcional. Sirve para calcular el volumen.
bultos[0][altoCm] double Alto del bulto en cm. Opcional. Sirve para calcular el volumen.
bultos[0][volumen] double Volumen del bulto en cm3. Es obligatorio ingresar volumen, peso o peso aforado.
bultos[0][kilos] double Peso del bulto en kilos. Es obligatorio ingresar volumen, peso o peso aforado.
bultos[0][pesoAforado] double Peso aforado del bulto en kilos. Es obligatorio ingresar volumen, peso o peso aforado.
bultos[0][valorDeclarado] integer Valor declarado del contenido del bulto. Sirve para el seguro. Obligatorio.
bultos[0][categoria] string Categoria del bulto. Solo aplica a ciertos contratos. Invalida a los otros campos del bulto. Opcional.
Response:
{
   "pesoAforado":"70.00",
   "tarifaSinIva":{
      "seguroDistribucion":"12.21",
      "distribucion":"5806.97",
      "total":"5819.18"
   
   },
   "tarifaConIva":{
      "seguroDistribucion":"14.77",
      "distribucion":"7026.43",
      "total":"7041.21"
   
   }
}

List all provinces

List all provinces

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: regiones

Response:
[
  {
    "meta": "AR-B",
    "contenido": "Buenos Aires"
  },
  {
    "meta": "AR-K",
    "contenido": "Catamarca"
  },
  {
    "meta": "AR-H",
    "contenido": "Chaco"
  },
  {
    "meta": "AR-U",
    "contenido": "Chubut"
  },
  {
    "meta": "AR-X",
    "contenido": "Córdoba"
  },
  {
    "meta": "AR-W",
    "contenido": "Corrientes"
  },
  {
    "meta": "AR-E",
    "contenido": "Entre Ríos"
  }
]

List all branches

List all branches

Productive URL: https://api.andreani.com
QA URL: https://api.qa.andreani.com
Method: sucursales

Response:
    {
    [
      {
        "nomenclatura": "CNQ",
        "descripcion": "CORRIENTES",
        "direccion": {
          "localidad": "CORRIENTES",
          "region": "CORRIENTES",
          "pais": "Argentina",
          "codigoPostal": "3400",
          "componentesDeDireccion": [
            {
              "meta": "Calle",
              "contenido": "Belgrano"
            },
            {
              "meta": "Numero",
              "contenido": "275"
            }
          ]
        },
        "telefonos": [
          {
            "tipo": 2,
            "numero": "(03783) 42-0332"
          }
        ],
        "geocoordenadas": {
          "elevacion": 0,
          "latitud": -33.0133,
          "longitud": -58.53697
        },
        "datosAdicionales": [
          {
            "meta": "seHaceAtencionAlCliente",
            "contenido": "True"
          }
        ],
        "id": "48",
        "horarioDeAtencion": "Lunes a Viernes de 08:00 a 17:00 . Sábado de 08:00 a 12:00"
      }
    ]
    }