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.
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:
Key | Type | Description |
---|---|---|
contrato | string | Código de contrato con Andreani. Obligatorio. |
tipoServicio | string | Tipo de entrega a realizar. Ej: Domicilio / Sucursal. Opcional. |
sucursalClienteID | string | Identificador de la sucursal del remitente. Opcional. |
origen | object | Origen del envío. El objeto origen debe contener un objeto de tipo postal ó sucursal. Obligatorio. |
origen.postal | object | Dirección origen del envío, dirección del remitente. Es obligatorio si origen no contiene un objeto sucursal. |
origen.postal.localidad | string | Localidad origen del envío. Obligatorio. Maximo caracteres guardados: 40. |
origen.postal.region | string | Región origen del envío codificado en ISO 3166-2:AR. Opcional. |
origen.postal.pais | string | País origen del envío. Opcional. Por defecto Argentina. |
origen.postal.codigoPostal | string | Código postal origen del envío. Obligatorio. Maximo caracteres guardados: 12. |
origen.postal.calle | string | Calle del origen del envío. Obligatorio.Maximo caracteres guardados: 40. |
origen.postal.numero | string | Altura de la calle del origen del envío. Obligatorio. Maximo caracteres guardados: 40. |
origen.postal.componentesDeDireccion | array | Datos adicionales de la dirección(piso, entrecalles, etc.). Es de tipo meta-contenido libre. Opcional. Maximo caracteres guardados: 40. |
origen.sucursal | object | Sucursal de imposición, origen del envío, se debe calcular con API de sucursales, una con atencion al cliente. Obligatorio si no se incluye uno objeto postal para el origen. |
origen.sucursal.id | string | Identificador de la sucursal Andreani, en la que se impondrá y dara comienzo al flujo operativo. Obligatorio. |
destino | object | Destino del envío. Debe contener un objeto del tipo postal o sucursal. Obligatorio. |
destino.postal | object | Dirección destino del envío. Obligatorio para entrega en una dirección postal como por ejemplo el domicilio. |
destino.postal.localidad | string | Localidad destino del envío. Obligatorio. Maximo caracteres guardados: 40. |
destino.postal.region | string | Región destino del envío codificado en ISO 3166-2:AR. Opcional. |
destino.postal.pais | string | País destino del envío. Opcional. Por defecto Argentina. |
destino.postal.codigoPostal | string | Código postal destino del envío. Obligatorio. Maximo caracteres guardados: 12. |
destino.postal.calle | string | Calle del destino del envío. Obligatorio. Maximo caracteres guardados: 40. |
destino.postal.numero | string | Altura de la calle del destino del envío. Obligatorio. Maximo caracteres guardados: 40. |
destino.postal.componentesDeDireccion | array | Datos adicionales de la dirección(piso, entrecalles, etc.). Es de tipo meta-contenido libre. Opcional. Maximo caracteres guardados: 40. |
destino.sucursal.id | string | Identificador de la sucursal Andreani destino del envío, debe tener atencion al cliente, por la cual se retirará el envío. Obligatorio para entrega en sucursal. |
remitente | object | Datos del remitente del envío. Obligatorio. |
remitente.nombreCompleto | string | Nombre o razón social del remitente del envío. Obligatorio. Maximo caracteres guardados: 40. |
remitente.eMail | string | Correo electrónico del remitente del envío. Obligatorio. |
remitente.documentoTipo | string | Tipo de documento del remitente del envío. Posibles: DNI/CUIT/CUIL XXXXXXXX. Obligatorio. |
remitente.documentoNumero | string | Número de documento del remitente del envío. Obligatorio. Maximo caracteres guardados: 20. |
remitente.telefonos | object | Telefonos del remitente del envío. |
remitente.telefonos.tipo | integer | Tipo de telefono del remitente del envío. Trabajo = 0, Celular =1, Casa = 2, Otros = 3. Obligatorio. |
remitente.telefonos.numero | string | Número de telefono del remitente del envío. Obligatorio. Maximo caracteres guardados: 15. |
destinatario[] | object | Datos del destinatario del envío. Es posible ingresar un destinatario alternativo como segundo elemento. Obligatorio. |
destinatario.nombreCompleto | string | Nombre o razón social del destinatario del envío. Obligatorio. Maximo caracteres guardados: 40. |
destinatario.eMail | string | Correo electrónico del destinatario del envío. Obligatorio. Maximo caracteres guardados: 40. |
destinatario.documentoTipo | string | Tipo de documento del destinatario del envío. Posibles: DNI/CUIT/CUIL XXXXXXXX. Obligatorio. |
destinatario.documentoNumero | string | Número de documento del destinatario del envío. Obligatorio. Maximo caracteres guardados: 20. |
destinatario.telefonos | object | Telefonos del destinatario del envío. |
destinatario.telefonos.tipo | integer | Tipo de telefono del destinatario del envío. Trabajo = 1, Celular =2, Casa = 3, Otros = 4. Obligatorio. |
destinatario.telefonos.numero | string | Número de telefono del destinatario del envío. Obligatorio. Maximo caracteres guardados: 15. |
remito | object | Remito. Opcional. |
remito.numeroRemito | string | Numero de remito. Opcional. Maximo caracteres guardados: 35. |
remito.complementarios[] | string | Numeros de remitos complementarios. Opcional. |
centroDeCostos | string | Centro de costos del envios. Opcional. Maximo caracteres guardados: 40. |
productoAEntregar | string | Descripcion del producto a entregar. Opcional. |
productoARetirar | string | Descripcion del producto a retirar. Opcional. |
tipoProducto | string | Categoría de producto a enviar. Ej: Linea Blanca, Electrodoméstico, etc. Opcional. |
categoriaFacturacion | string | Categoria de facturacion. Opcional. |
pagoDestino | integer | Tipo de porte. Porte = 1, Debido = 2 . Opcional. |
valorACobrar | double | Valor a cobrar total al destinatario, en caso que no se completen los valorDeclaradoConImpuestos en los bultos. Opcional. Maximo caracteres guardados: 12,2 |
fechaDeEntrega | object | Fecha y hora de entrega pactada. Opcional. |
fechaDeEntrega.fecha | integer | Fecha de entrega pactada. YYYY-mm-dd. Opcional. |
fechaDeEntrega.horaDesde | integer | Hora disponible desde. Opcional. |
fechaDeEntrega.horaHasta | integer | Hora disponible hasta. Opcional. |
codigoVerificadorDeEntrega | string | Codigo para verificar la entrega. Opcional. |
bultos | array | Datos de cada bulto del envío. Obligatorio. |
bultos.kilos | double | Peso del bulto en kilos. Obligatorio. Maximo caracteres guardados: 12,3 |
bultos.largoCm | double | Largo del bulto en cm. Opcional. |
bultos.altoCm | double | Alto del bulto en cm. Opcional. |
bultos.anchoCm | double | Ancho del bulto en cm. Opcional. |
bultos.volumenCm | double | Volumen del bulto en cm3. Obligatorio. Maximo caracteres guardados: 6,3 |
bultos.valorDeclaradoSinImpuestos | double | Valor del bulto sin impuestos para el seguro de distribución. Opcional. Maximo caracteres guardados: 12,2 |
bultos.valorDeclaradoConImpuestos | double | Valor del bulto con impuestos para gestiones cobranza. Opcional. |
bultos.descripcion | string | Descripcion del bulto. Opcional. |
bultos.referencias | array | Referencias del bulto. Es de tipo meta-contenido. Para asociar bultos en B2C, enviar el meta idCliente con el mismo contenido. Para asociar observaciones en la etiqueta enviar el meta observaciones. Opcional. |
bultos.numeroDeEnvio | string | Numero de tracking del envío en caso de tener una pre-numeración asignada. Opcional. |
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://apisqa.andreani.com/v2/360000000036820/etiquetas" } ] }, { "numeroDeBulto": "2", "numeroDeEnvio": "360000000036830", "totalizador": "2/2", "linking": [ { "meta": "Etiqueta", "contenido": "https://apisqa.andreani.com/v2/360000000036830/etiquetas" } ] } ], "fechaEstimadaDeEntrega": "", "huellaDeCarbono": "", "gastoEnergetico": "" }
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://apisqa.andreani.com/v2/360000000036820/etiquetas" } ] }, { "numeroDeBulto": "2", "numeroDeEnvio": "360000000036830", "totalizador": "2/2", "linking": [ { "meta": "Etiqueta", "contenido": "https://apisqa.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}
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
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
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" } ] }
Branch by contract
List all Andreani branches assigned by contract. Requires authentication. Only for B2C channel
Productive URL: https://apis.andreani.com
QA URL: https://apisqa.andreani.com
Method: puntos-de-tercero
Body Values:
Key | Type | Description |
---|---|---|
contrato | string | Contrato de tipo B2C. Requerido. |
id | string | ID de la sucursal. Opcional. |
admiteEnvios | bool | Admite Envios. Opcional. |
entregaEnvios | bool | Entrega Envios. Opcional. |
codigo | string | Codigo de la sucursal.Opcional. |
sucursal | string | nombre de la sucursal abreviado. Opcional. |
region | string | nombre de la region abreviado. Opcional. |
localidad | string | nombre de la localidad. Opcional. |
codigoPostal | string | codigo postal atendido por la sucursal deseada. Opcional. |
canal | string | canal (B2C/B2B). Opcional. |
seHaceAtencionAlCliente | bool | Si se hace atencion al cliente . Opcional. |
conBuzonInteligente | bool | Con Buzon Inteligente. Opcional. |
numero | string | ID de la sucursal no unificado. Opcional. |
Response:
[ { "id": 10048, "codigo": "CNQ", "numero": "48", "descripcion": "CORRIENTES", "canal": "B2C", "direccion": { "calle": "Av. Independencia ", "numero": "3903", "provincia": "Corrientes", "localidad": "Corrientes", "region": "Nea", "pais": "Argentina", "codigoPostal": "3400" }, "coordenadas": { "latitud": "-27.479620", "longitud": "-58.804338" }, "horarioDeAtencion": "Lunes a Viernes de 08:00 a 18:00 - Sábados de 08:00 a 13:00", "datosAdicionales": { "seHaceAtencionAlCliente": true, "tipo": "SUCURSAL", "admiteEnvios": true, "entregaEnvios": true }, "telefonos": [ "0810-122-1111" ], "codigosPostalesAtendidos": [ "3485", "3411", "3406", "3480", "3473", "3436", "3402", "3449", "3441", "3483", "3412", "3487", "3414", "3481", "3405", "3454", "3403", "3400", "3401", "", "3407", "3410", "3409", "3416", "3404", "3453", "3408", "3418" ] } ]
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:
Key | Type | Description |
---|---|---|
localidad | string | Localidad/es por la/s que se desea filtrar. Opcional. |
provincia | string | Provincia/s por la/s que se desea filtrar. Opcional. |
idProvLocalidad | string | ID de la provincia que se desea consultar. Opcional. |
codigosPostales | string | Codigos postales por los que se desea filtrar. Opcional. |
partido | string | Partidos por los que se desea filtrar. Opcional. |
p | string | Paginacion; numero de localidades que se desea obtener. Opcional. |
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:
Key | Type | Description |
---|---|---|
planta | string | Planta. Obligatorio. |
almacen | string | Almacen. Obligatorio. |
contrato | string | Contrato. Obligatorio. |
pedido | object | Detalle del pedido. Obligatorio. |
pedido.propietario | string | Obligatorio. |
pedido.idPedido | string | Opcional. |
pedido.numero | string | Opcional. |
pedido.tipo | string | Obligatorio. |
pedido.prioridadDePreparacion | string | Opcional. |
pedido.fechaPedido | string | Opcional. |
pedido.fechaEntrega | string | Opcional. |
pedido.remito | string | Opcional. |
pedido.idCliente | string | Opcional. |
pedido.referenciaCliente | string | Opcional. |
pedido.codigoTransportista | string | Opcional. |
pedido.descripcionEmbalaje | string | Opcional. |
pedido.valorDeclaradoDelSeguro | string | Opcional. |
pedido.socioComercial | string | Opcional. |
pedido.modoDeTransporte | string | Opcional. |
pedido.destinatario | object | Obligatorio. |
pedido.destinatario.numeroDeDocumento | string | Opcional. |
pedido.destinatario.idDestinatario | string | Opcional. |
pedido.destinatario.idInternoCliente | string | Opcional. |
pedido.destinatario.nombreCompleto | string | Opcional. |
pedido.destinatario.email | string | Opcional. |
pedido.destinatario.tipoDeDocumento | string | Opcional. |
pedido.destinatario.contacto | string | Opcional. |
pedido.destinatario.telefonos | array | Opcional. |
pedido.destinatario.telefonos[].tipo | int | Opcional. |
pedido.destinatario.telefonos[].numero | string | Opcional. |
pedido.direccion | object | Obligatorio. |
pedido.direccion.calle | string | Opcional. |
pedido.direccion.numero | string | Opcional. |
pedido.direccion.codigoPostal | string | Opcional. |
pedido.direccion.localidad | string | Opcional. |
pedido.direccion.provincia | string | Opcional. |
pedido.direccion.pais | string | Opcional. |
pedido.direccion.piso | string | Opcional. |
pedido.direccion.Departamento | string | Opcional. |
pedido.direccion.referenciaDeDomicilio | string | Opcional. |
pedido.direccion.componentesDeDireccion | array | Opcional. |
pedido.direccion.componentesDeDireccion[].meta | string | Opcional. |
pedido.direccion.componentesDeDireccion[].contenido | string | Opcional. |
pedido.notas | array | Opcional. |
pedido.notas[].meta | string | Opcional. |
pedido.notas[].contenido | string | Opcional. |
pedido.camposLibres | array | Opcional. |
pedido.camposLibres[].meta | string | Opcional. |
pedido.camposLibres[].contenido | string | Opcional. |
pedido.datosAdicionales | array | Opcional. |
pedido.datosAdicionales[].meta | string | Opcional. |
pedido.datosAdicionales[].contenido | string | Opcional. |
pedido.detalles | object | Opcional. |
pedido.detalles.numeroPedido | string | Opcional. |
pedido.detalles.unidadMedida | string | Obligatorio. |
pedido.detalles.lineaExterna | string | Opcional. |
pedido.detalles.unidades | float | Obligatorio. |
pedido.detalles.datosAdicionales | array | Opcional. |
pedido.detalles.datosAdicionales[].meta | string | Opcional. |
pedido.detalles.datosAdicionales[].contenido | string | Opcional. |
pedido.detalles.articulo | object | Obligatorio. |
pedido.detalles.articulo.codigo | string | Obligatorio. |
pedido.detalles.articulo.propietario | string | Opcional. |
pedido.detalles.articulo.lote | object | Opcional. |
pedido.detalles.articulo.lote.idLote | string | Opcional. |
pedido.detalles.articulo.lote.Codigo | string | Opcional. |
pedido.detalles.articulo.lote.loteDeFabricante | string | Opcional. |
pedido.detalles.articulo.lote.fechaDeVencimiento | string | Opcional. |
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:
Key | Type | Description |
---|---|---|
almacen | string | Almacen. Obligatorio. |
contrato | string | Contrato. Obligatorio. |
planta | string | Planta. Obligatorio. |
ordenDeCompra | object | Obligatorio. |
ordenDeCompra.direccionComprador | object | Obligatorio. |
ordenDeCompra.comprador | object | Obligatorio. |
ordenDeCompra.fechaDeRecepcionEsperada | string | Opcional. |
ordenDeCompra.ReferenciaDeOrdenDeCompraDeCliente | string | Opcional. |
ordenDeCompra.idOrdenDeCompra | string | Opcional. |
ordenDeCompra.ordenDeCompraDeCliente | string | Obligatorio. |
ordenDeCompra.condicionDeEntrega | string | Opcional. |
ordenDeCompra.notas | string | Opcional. |
ordenDeCompra.direccionProveedor | object | Obligatorio. |
ordenDeCompra.proveedor | object | Obligatorio. |
ordenDeCompra.lugarDeEntrega | string | Opcional. |
ordenDeCompra.lugarDeDescarga | string | Opcional. |
ordenDeCompra.lugarDeCarga | string | Opcional. |
ordenDeCompra.fechaOrdenDeCompra | string | Opcional. |
ordenDeCompra.tipoDeOrdenDeCompra | string | Opcional. |
ordenDeCompra.propietario | string | Obligatorio. |
ordenDeCompra.camposLibres | array | Opcional. |
ordenDeCompra.transportista | string | Opcional. |
ordenDeCompra.detallesOrdenDeCompra | object | Obligatorio. |
ordenDeCompra.direccionComprador.calle | string | Opcional. |
ordenDeCompra.direccionComprador.codigoPostal | string | Opcional. |
ordenDeCompra.direccionComprador.nombreProvincia | string | Opcional. |
ordenDeCompra.direccionComprador.numero | string | Opcional. |
ordenDeCompra.direccionComprador.pais | string | Opcional. |
ordenDeCompra.direccionComprador.localidad | string | Opcional. |
ordenDeCompra.direccionComprador.piso | string | Opcional. |
ordenDeCompra.direccionComprador.departamento | string | Opcional. |
ordenDeCompra.direccionComprador.componentesDeDireccion | array | Opcional. |
ordenDeCompra.comprador.datosPersonales | object | Opcional. |
ordenDeCompra.comprador.contacto | string | Opcional. |
ordenDeCompra.comprador.otrosDatos | array | Opcional. |
ordenDeCompra.comprador.datosPersonales.numeroDeDocumento | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.nombreCompleto | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.idInternoDelCliente | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.email | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.telefonos | object | Opcional. |
ordenDeCompra.comprador.datosPersonales.agrupador | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.tipoDeDocumento | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.telefonos.tipo | string | Opcional. |
ordenDeCompra.comprador.datosPersonales.telefonos.numero | string | Opcional. |
ordenDeCompra.comprador.otrosDatos.meta | string | Opcional. |
ordenDeCompra.comprador.otrosDatos.contenido | string | Opcional. |
ordenDeCompra.direccionProveedor.calle | string | Opcional. |
ordenDeCompra.direccionProveedor.codigoPostal | string | Opcional. |
ordenDeCompra.direccionProveedor.nombreProvincia | string | Opcional. |
ordenDeCompra.direccionProveedor.numero | string | Opcional. |
ordenDeCompra.direccionProveedor.pais | string | Opcional. |
ordenDeCompra.direccionProveedor.localidad | string | Opcional. |
ordenDeCompra.direccionProveedor.piso | string | Opcional. |
ordenDeCompra.direccionProveedor.departamento | string | Opcional. |
ordenDeCompra.direccionProveedor.componentesDeDireccion | array | Obligatorio. |
ordenDeCompra.direccionProveedor.componentesDeDireccion.meta | string | Opcional. |
ordenDeCompra.direccionProveedor.componentesDeDireccion.contenido | string | Obligatorio. |
ordenDeCompra.proveedor.datosPersonales | object | Opcional. |
ordenDeCompra.proveedor.contacto | string | Opcional. |
ordenDeCompra.proveedor.otrosDatos | array | Opcional. |
ordenDeCompra.proveedor.datosPersonales.numeroDeDocumento | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.nombreCompleto | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.idInternoDelCliente | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.email | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.telefonos | object | Opcional. |
ordenDeCompra.proveedor.datosPersonales.agrupador | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.tipoDeDocumento | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.telefonos.tipo | string | Opcional. |
ordenDeCompra.proveedor.datosPersonales.telefonos.numero | string | Opcional. |
ordenDeCompra.camposLibres.meta | string | Opcional. |
ordenDeCompra.camposLibres.contenido | string | Opcional. |
ordenDeCompra.detallesOrdenDeCompra.numeroDeLineaDeCliente | string | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.notasDeLinea | string | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.notasDeLinea | string | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.numeroDeLinea | string | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.cantidadPedida | float32 | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.articulo | object | Obligatorio. |
ordenDeCompra.detallesOrdenDeCompra.camposLibres | array | Opcional. |
ordenDeCompra.detallesOrdenDeCompra.camposLibres.meta | string | Opcional. |
ordenDeCompra.detallesOrdenDeCompra.camposLibres.contenido | string | Opcional. |
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/stock
Body Values:
Key | Type | Description |
---|---|---|
cliente | string | Cliente. Obligatorio. |
articulo | string | Ariculo. Obligatorio. |
fecha | date - YYYY-MM-DD | Fecha. Obligatorio si no se indica fechaDesde y fechaHasta |
fechaDesde | date - YYYY-MM-DD | Fecha desde. Obligatorio si no se indica el campo fecha. |
fechaHasta | date - YYYY-MM-DD | Fecha hasta. Obligatorio si no se indica el campo fecha. |
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:
Key | Type | Description |
---|---|---|
planta | string | Planta. Obligatorio. |
articulo | string | Almacen. Obligatorio. |
contrato | string | Contrato. Obligatorio. |
numeroDeOrden | string | Obligatorio. |
vencimiento | string | Obligatorio. |
uRIConsulta | string | Opcional. |
altaMaestroLoteSolicitada | object | Obligatorio. |
altaMaestroLoteSolicitada.propietario | string | Opcional. |
altaMaestroLoteSolicitada.articulo | string | Opcional. |
altaMaestroLoteSolicitada.paquete | string | Opcional. |
altaMaestroLoteSolicitada.loteCaja | string | Opcional. |
altaMaestroLoteSolicitada.loteSap | string | Opcional. |
altaMaestroLoteSolicitada.fechaFabricacion | string | Opcional. |
altaMaestroLoteSolicitada.fechaVencimiento | string | Opcional. |
altaMaestroLoteSolicitada.campoLibre1 | string | Opcional. |
altaMaestroLoteSolicitada.campoLibre2 | string | Opcional. |
altaMaestroLoteSolicitada.campoLibre3 | string | Opcional. |
altaMaestroLoteSolicitada.campoLibre4 | string | Opcional. |
altaMaestroLoteSolicitada.campoLibre5 | string | Opcional. |
altaMaestroLoteSolicitada.loteExternoCliente | string | Opcional. |
altaMaestroLoteSolicitada.deliverByDate | string | Opcional. |
altaMaestroLoteSolicitada.bestByDate | string | Opcional. |
altaMaestroLoteSolicitada.fechaCreacion | string | Opcional. |
altaMaestroLoteSolicitada.usuarioCreacion | string | Opcional. |
altaMaestroLoteSolicitada.fechaEdicion | string | Opcional. |
altaMaestroLoteSolicitada.usuarioEdicion | string | Opcional. |
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:
Key | Type | Description |
---|---|---|
planta | string | Planta. Obligatorio. |
almacen | string | Almacen. Obligatorio. |
contrato | string | Contrato. Obligatorio. |
detalleDeArticulo | object | Detalle del articulo. Obligatorio. |
detalleDeArticulo.codigoArticulo | string | Codigo de articulo. Obligatorio. |
detalleDeArticulo.propietario | string | Propietario. Obligatorio. |
detalleDeArticulo.descripcion | string | Descripcion. Obligatorio. |
detalleDeArticulo.claseDeExpedicion | string | Clase de expedición. Opcional. |
detalleDeArticulo.claseDeArticulo | string | Clase de articulo. Opcional. |
detalleDeArticulo.paisDeOrigen | string | Pais de origen. Opcional. |
detalleDeArticulo.numeroDeSerieDeEntradaUnico | boolean | Opcional. |
detalleDeArticulo.capturaDatosEntrada | boolean | Opcional. |
detalleDeArticulo.numeroDeSerieSalidaUnico | boolean | Opcional. |
detalleDeArticulo.capturaDatosSalida | boolean | Opcional. |
detalleDeArticulo.capturaTotalNumSeries | boolean | Opcional. |
detalleDeArticulo.notas | string | Notas. Opcional. |
detalleDeArticulo.instruccionesDePreparacion | string | Opcional. |
detalleDeArticulo.vidaUtilEnDias | int | Opcional. |
detalleDeArticulo.codigoDeVidaUtil | string | Opcional. |
detalleDeArticulo.indicadorDeVidaUtil | string | Opcional. |
detalleDeArticulo.consumoEnDias | int | Opcional. |
detalleDeArticulo.vencimientoEnDias | int | Opcional. |
detalleDeArticulo.vidaUtilEntradaEnDias | int | Opcional. |
detalleDeArticulo.consumoEnDias | int | Opcional. |
detalleDeArticulo.volumen | float | Opcional. |
detalleDeArticulo.pesoBruto | float | Opcional. |
detalleDeArticulo.pesoTara | float | Opcional. |
detalleDeArticulo.pesoNeto | float | Opcional. |
detalleDeArticulo.lote | object | Opcional. |
detalleDeArticulo.lote.idLote | object | Codigo del lote. Opcional. |
detalleDeArticulo.lote.loteDeFabricante | object | Opcional. |
detalleDeArticulo.lote.fechaDeVencimiento | object | Opcional. |
detalleDeArticulo.lote.datosAdicionales | array | Opcional. |
detalleDeArticulo.lote.datosAdicionales[].meta | string | Opcional. |
detalleDeArticulo.lote.datosAdicionales[].contenido | string | Opcional. |
detalleDeArticulo.otrosDatos | array | Opcional. |
detalleDeArticulo.otrosDatos[].meta | string | Opcional. |
detalleDeArticulo.otrosDatos[].contenido | string | Opcional. |
detalleDeArticulo.caracteristicas | array | Opcional. |
detalleDeArticulo.caracteristicas[].meta | string | Opcional. |
detalleDeArticulo.caracteristicas[].contenido | string | Opcional. |
detalleDeArticulo.grupos | array | Opcional. |
detalleDeArticulo.grupos[].meta | string | Opcional. |
detalleDeArticulo.grupos[].contenido | string | Opcional. |
detalleDeArticulo.camposLibres | array | Opcional. |
detalleDeArticulo.camposLibres[].meta | string | Opcional. |
detalleDeArticulo.camposLibres[].contenido | string | Opcional. |
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}}
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:
Key | Type | Description |
---|---|---|
contrato | string | Código de contrato con Andreani. Obligatorio. |
almacen | string | Almacen Andreani. Obligatorio. |
planta | string | Planta Andreani. Obligatorio. |
destinatario | object | Destinatario. Obligatorio. |
destinatario.propietario | string | Propietario. Obligatorio. |
destinatario.tipo | string | Tipo. Obligatorio. |
destinatario.direccion | string | Direccion. Obligatorio. |
destinatario.ciudad | string | Ciudad. Obligatorio. |
destinatario.compania | string | Compania. Obligatorio. |
destinatario.pais | string | Pais. Obligatorio. |
destinatario.descripcion | string | Descripcion. Opcional. |
destinatario.lugar | string | Lugar. Opcional. |
destinatario.telefono | string | Telefono. Opcional. |
destinatario.provincia | string | Provincia. Opcional. |
destinatario.identificadorFiscal | string | Identificador fistal. Obligatorio. |
destinatario.codigopostal | string | Codigo Postal. Opcional. |
destinatario.sigla | string | Sigla. Obligatorio. |
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}
