Authentication

Before invoking any API, the client must get an authetication token from this API to use in the others calls. The credentials will be provided previously. In the header you must send a label with the supplied data: Authorization: Basic base64_encoded (user: password). In the response header, a token with the x-authorization-token tag will be returned. The same must be sent in all subsequent calls. The same token can be used until it expires and must be authenticated again.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: login

Create a new order

A shipping order is all the logical data that will become in a shipping. In this way Andreani can plan the delivery without having the load still in his possession. The shipment can be accepted at any andreani branch when its status is "Created".

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: ordenes-de-envio

Body Values:

Response:

{
      "estado": "Pendiente",
      "tipo": "B2C",
      "sucursalDeDistribucion": {
          "nomenclatura": "BAR",
          "descripcion": "BARRACAS",
          "id": "46"
      },
      "sucursalDeRendicion": {
          "nomenclatura": "REN",
          "descripcion": "PROVEEDOR RENDICIONES",
          "id": "-1"
      },
      "sucursalDeImposicion": {
          "nomenclatura": "",
          "descripcion": "",
          "id": ""
      },
	  "sucursalAbastecedora": {},
      "fechaCreacion": "2021-09-06T15:47:57-03:00",
      "zonaDeReparto": "",
      "numeroDePermisionaria": "RNPSP Nº 586",
      "descripcionServicio": "Contrato de TEST WebService",
      "etiquetaRemito": "",
      "bultos": [
          {
              "numeroDeBulto": "1",
              "numeroDeEnvio": "360000000036820",
              "totalizador": "1/2",
              "linking": [
                  {
                      "meta": "Etiqueta",
                      "contenido": "https://apisqa.andreani.com/v2/API0000000030839/etiquetas"
                  }
              ]
          },
          {
              "numeroDeBulto": "2",
              "numeroDeEnvio": "360000000036830",
              "totalizador": "2/2",
              "linking": [
                  {
                      "meta": "Etiqueta",
                      "contenido": "https://apisqa.andreani.com/v2/API0000000030839/etiquetas"
                  }
              ]
          }
      ],
      "agrupadorDeBultos": "API0000000030839",
      "etiquetasPorAgrupador": "https://apisqa.andreani.com/v2/ordenes-de-envio/API0000000030839/etiquetas"
  }

Get a new order

Get a new order

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: ordenes-de-envio/{numeroAndreani}

Response:

{
      "estado": "Pendiente",
      "tipo": "B2C",
      "sucursalDeDistribucion": {
          "nomenclatura": "BAR",
          "descripcion": "BARRACAS",
          "id": "46"
      },
      "sucursalDeRendicion": {
          "nomenclatura": "REN",
          "descripcion": "PROVEEDOR RENDICIONES",
          "id": "-1"
      },
      "sucursalDeImposicion": {
          "nomenclatura": "",
          "descripcion": "",
          "id": ""
      },
      "fechaCreacion": "2020-05-06T15:47:57-03:00",
      "zonaDeReparto": "",
      "numeroDePermisionaria": "RNPSP Nº 586",
      "descripcionServicio": "Contrato de TEST WebService",
      "etiquetaRemito": "",
      "bultos": [
          {
              "numeroDeBulto": "1",
              "numeroDeEnvio": "360000000036820",
              "totalizador": "1/2",
              "linking": [
                  {
                      "meta": "Etiqueta",
                      "contenido": "https://api.qa.andreani.com/v2/360000000036820/etiquetas"
                  }
              ]
          },
          {
              "numeroDeBulto": "2",
              "numeroDeEnvio": "360000000036830",
              "totalizador": "2/2",
              "linking": [
                  {
                      "meta": "Etiqueta",
                      "contenido": "https://api.qa.andreani.com/v2/360000000036830/etiquetas"
                  }
              ]
          }
      ],
      "fechaEstimadaDeEntrega": "",
      "huellaDeCarbono": "",
      "gastoEnergetico": ""
  }

Get a label

Get a label

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: ordenes-de-envio/{numeroAndreani}/etiquetas

Get the traces of a shipment

Returns all movements of a shipment by Andreani number. For this version you need to configure your username by the Andreani team. Contact your salesperson. Translations: Shipping API - Status and reasons

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: envios/{numeroAndreani}/trazas

Response:

{
   'eventos': [
     {
       'Fecha': '2021-03-09T11:08:03',
       'Estado': 'Pendiente de ingreso',
       'EstadoId': 1,
       'Traduccion': 'ENVIO INGRESADO AL SISTEMA',
       'Sucursal': 'Sucursal Genérica',
       'SucursalId': 999,
       'Ciclo': 'Distribution'
     },
     {
       'Fecha': '2021-03-09T11:08:09',
       'Estado': 'Ingreso al circuito operativo',
       'EstadoId': 5,
       'Traduccion': 'ENVIO INGRESADO AL SISTEMA',
       'Sucursal': 'Monserrat',
       'SucursalId': 12,
       'Ciclo': 'Distribution'
     },
     {
       'Fecha': '2021-03-09T11:53:55',
       'Estado': 'En distribución',
       'EstadoId': 6,
       'Traduccion': 'ENVIO CON SALIDA A REPARTO',
       'Sucursal': 'Monserrat',
       'SucursalId': 12,
       'Ciclo': 'Distribution'
     },
     {
       'Fecha': '2021-03-09T11:59:04',
       'Estado': 'Visita', 
       'EstadoId': 11,  
       'Motivo': 'No se encuentra el titular',
       'MotivoId': 36, 
       'Traduccion': 'No se encuentra el titular',
       'Sucursal': 'Monserrat', 
       'SucursalId': 12,  
       'Ciclo': 'Distribution'
     }
   ]
 }

Get a shipment

Shipping API - Status and reasons

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: envios/{numeroAndreani}

Response:

{
    'numeroDeTracking': '360000044179430',
    'contrato': '300006611',
    'ciclo': 'Distribution',
    'estado': 'Pendiente',
    'estadoId': 21,
    'fechaEstado': '2021-03-09T11:59:04',
    'sucursalDeDistribucion': {
      'nomenclatura': 'MONSERRAT',
      'descripcion': 'Monserrat',
      'id': 12
    },
    'fechaCreacion': '2021-03-10T11:18:01',
    'destino': {
      'Postal': {
        'localidad': 'C.A.B.A.',
        'pais': 'Argentina',
        'direccion': 'AV J MANUEL DE ROSAS 380',
        'codigoPostal': '1002'
      }
    },
    'remitente': {},
    'destinatario': {
      'nombreYApellido': 'Juana Gonzalez',
      'tipoYNumeroDeDocumento': 'PAS783297632',
      'eMail': 'destinatario@andreani.com'
    },
    'bultos': [
      {
        'kilos': 0.005,
        'valorDeclaradoConImpuestos': 1452,
        'IdDeProducto': '123456789',
        'volumen': 0.000005
      }
    ],
    'idDeProducto': '123456789',
    'referencias': [
      '360000044179430',
      '2',
      'B',
      '123456789'
    ]
  }

Shipping tracking

Shipping API - Status and reasons

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: envios

Response:

{
  "envios": [
    {
      "numeroDeTracking": "360000044181750",
      "contrato": "300006611",
      "ciclo": "Distribution",
      "estado": "Pendiente",
      "estadoId": 21,
      "fechaEstado": "2021-04-09T11:25:13",
      "sucursalDeDistribucion": {
        "nomenclatura": "MONSERRAT",
        "descripcion": "Monserrat",
        "id": 12
      },
      "fechaCreacion": "2021-04-09T11:25:13",
      "destino": {
        "Postal": {
          "localidad": "C.A.B.A.",
          "pais": "Argentina",
          "direccion": "AV J MANUEL DE ROSAS 380",
          "codigoPostal": "1002"
        }
      },
      "remitente": {},
      "destinatario": {
        "nombreYApellido": "Juana Gonzalez",
        "tipoYNumeroDeDocumento": "12345678",
        "eMail": "destinatario@andreani.com"
      },
      "bultos": [
        {
          "kilos": 0.005,
          "valorDeclaradoConImpuestos": 1200,
          "IdDeProducto": "123456789",
          "volumen": 0.000005
        }
      ],
      "idDeProducto": "123456789",
      "referencias": [
        "360000044181750",
        "2",
        "B",
        "123456789"
      ]
    }
  ]
}

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://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: tarifas

Body Values:

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 branches

Versión v2 Versión v1

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.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"
        }
      ]
      }

List all multimedia

List all the documents of a shipment, this documents could be "Constancias Electrónicas", "Constancias de hojas de ruta", "remitos" or another digital document.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: envios/{numeroAndreani}/multimedia

Response:

{
     "numeroDeEnvio": "360000036137650",
     "multimedia": [
       {
         "meta": "constanciaelectronica",
         "contenido": "link"
       }
     ]
   } 

Returns all the towns of the Argentine Republic, along with their postal codes. Does not require authorization

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: localidades

Body Values:

Response:

[
     {
        "idDeProvLocalidad":107362,
        "localidad":"PASO DE LOS LIBRES",
        "provincia":"CORRIENTES",
        "codigosPostales":[
           "3230"
        ]
     }
     ...
  ]

Post Orders

Register an order for several products, previously validating the request that you enter

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/{idAlmacen}/pedidos

Body Values:

Response:

{ "idTransaccion": 0 }

Post Ordens

Through this interface it is possible to inform Andreani of the logical information regarding the merchandise that Andreani will be receiving and storing in our Warehouse.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/{idAlmacen}/orden-de-compra

Body Values:

Response:

{ "idTransaccion": 0 }

Get a label

Through this interface, the logical information of the stock that we have registered in the Andreani warehouses is provided so that the client can reconcile with the stock registered in their system.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/foto-de-stock

Body Values:

Response:

[ {​ "Propietario": "CLIENTEPRUEBA", "Articulo": "1352099-011-LG", "Descripcion": "Sportstyle Jogger-GRYLG", "Ean": "194511195840", "Tipo_Articulo": "APPAREL", "Warehouse": "WMWHSE1", "Almacen_bloqueo": "OK", "Estado_del_lote": "OK", "Lote_Interno_SCE": "0000026595", "Atributo_de_lote_01": "", "Lote_Caja": "X565C", "Atributo_de_lote_03": "X565C", "Atributo_de_lote_04": "", "Vencimiento": "2016-08-30 12:00:00", "Atributo_de_lote_06": "", "Atributo_de_lote_07": "", "Atributo_de_lote_08": "", "Atributo_de_lote_09": "", "Atributo_de_lote_10": "", "Lote_Externo": "X565C", "Atributo_de_lote_12": "", "Atributo_de_lote_13": "", "Total_Unidades": "43", "Unidades_asignadas": "0", "Unidades_preparadas": "0", "Unidades_Bloqueadas": "0" }​ ]

Post Orders

Register a batch

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/{idAlmacen}/lotes

Body Values:

Response:

{ "idTransaccion": 0 }

Post Order confirmation

List all (or one) Andreani's multimedia associated with a shipment. The multimedia available are: Electronic Certificates, Roadmap Certificates, remittances and other digitized documents. Requires authorization.

Productive URL: A Definir por el cliente
QA URL: A Definir por el cliente
Method: A Definir por el cliente

Through this interface the client can not only register new items from their stock but also modify attributes of pre-existing items in the warehouse.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/productos/{codigoArticulo}/mantenimiento

Body Values:

Response:

{ "idTransaccion": 0 }

Through this interface, the customer can not only consult items from their current stock.

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/productos/{codigoArticulo}/mantenimiento/{idTransaccion}

Response:

{"estado":"string","request":{"almacen":"string","contrato":"string","detalleDeArticulo":{"camposLibres":{"ListaDePropiedades":[{"contenido":"string","meta":"string"}]},"caracteristicas":{"ListaDePropiedades":[{"contenido":"string","meta":"string"}]},"claseDeArticulo":"string","claseDeExpedicion":"string","codigo":"string","codigoDeVidaUtil":"string","consumoEnDias":0,"descripcion":"string","esNumeroDeSerieDeEntradaUnico":true,"esNumeroDeSerieSalidaUnico":true,"grupos":{"ListaDePropiedades":[{"contenido":"string","meta":"string"}]},"indicadorDeVidaUtil":"string","instruccionesDePreparacion":"string","lote":{"codigo":"string","datosAdicionales":{"ListaDePropiedades":[{"contenido":"string","meta":"string"}]},"fechaDeVencimiento":"string","loteDeFabricante":"string"},"notas":"string","otrosDatos":{"ListaDePropiedades":[{"contenido":"string","meta":"string"}]},"paisDeOrigen":"string","pesoBruto":0,"pesoNeto":0,"pesoTara":0,"propietario":"string","requiereCapturaDatosEntrada":true,"requiereCapturaDatosSalida":true,"requierecapturaTotalNumSeries":true,"vencimientoEnDias":0,"vidaUtilEnDias":0,"vidaUtilEntradaEnDias":0,"volumen":0},"planta":"string"},"response":{"idTransaccion":0}}

Batch Status Update

Through this API, you will be able to update the actual state of a certain lot. For example, if you want to update a lot status which is in HOLD state, to OK state

Productive URL: https://apisqa.andreani.com/v1/almacenes/{idalmacen}/lotes
QA URL: https://apisqa.andreani.com/v1/almacenes/{idalmacen}/lotes
Method: POST

Body Values:

Response:

{
  "idTransaccion": 33327
}

Through this interface Andreani will notify (PUSH) by means of a call to a Rest API the confirmation of receipt of merchandise. Among the data that can be reported are: Contract, Plant, Warehouse, Transaction ID, uri, owner, ExternalNumber, SceNumber, remittance, type, ReceptionConfDetail (storerkey, receiptkey, sku, description sku, quantity, uom, tolot externlineno, receiptlinenumber , lot.status, lotxlocxid.loc, loc.locationcategory, receipt.type, receiptdetail.lottable01)

Productive URL: A Definir por el cliente
QA URL: A Definir por el cliente
Method: A Definir por el cliente

Register a recipient, previously validating the request that he enters

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: almacenes/destinatarios

Body Values:

Response:

{ "idTransaccion": 0 }

Sending the movements generated by the shipments to a Web Service / API. The definition of the request, both the properties and the format of the data to be sent, is the responsibility of the client. You can count on security: Basic Authentication, OAUTH, OAUTH2, etc. Where: - idAndreani: It is the tracking code within Andreani systems. - idCliente: It is the tracking code within the client's system. - idTraza: Unique identifier of movement in Andreani systems. It can be used to sort the received entries or to discard duplicate entries. - event: It is the Client Code 1. - reason: It is the Client Code 2. It should be clarified that the names of the properties can be changed by those defined by the client

Productive URL: A Definir por el cliente
QA URL: A Definir por el cliente
Method: A Definir por el cliente

QR Code

Generates a QR with the sent information

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: codigos-qr/{informacion}

Bar code

Generates a bar code with the sent information

Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: codigos-de-barras/{informacion}