Skip to content

About

Ingreso de órdenes y consulta de datos para integraciones de Tango eCommerce

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

Tango Software - API REST de Tango eCommerce

API REST para integrar una tienda de comercio electrónico con Tango Gestión o Tango Punto de Venta: envío de órdenes y consulta de datos (artículos, clientes, precios, stock, comprobantes, etc.).

Índice de recursos

Todas las rutas parten de la base https://{llave}.connect.axoft.com/api/eCommerce. Todos los recursos requieren los headers ApiAuthorization y Company.

Método Ruta Descripción
POST /Dummy Verificación de credenciales (prueba de autenticación).
POST /Order Recibe una orden de la tienda para generar el pedido en Tango. Requiere ?Cuenta=.
POST /Order/Batch Recibe órdenes en lote (hasta 25) para generar los pedidos en Tango. Requiere ?Cuenta=.
GET /ArtPorSaldoStock Artículos filtrados por saldo de stock.
GET /CounterFoil Talonarios.
GET /Currency Monedas.
GET /CurrencyExchangeRate Cotizaciones de moneda extranjera.
GET /Customer Clientes.
GET /CustomersFolder Clasificador de clientes: clientes en carpetas.
GET /CustomersFolderClassifier Clasificador de clientes: carpetas.
GET /CustomersRelation Clasificador de clientes: relaciones.
GET /DiscountByCustomer Descuentos por cliente.
GET /Invoices Relación entre cada orden y el comprobante electrónico de su pedido facturado (con enlace al PDF).
GET /Measure Unidades de medida.
GET /Order Obtener información de las órdenes recibidas.
GET /Price Precios de artículos.
GET /PriceByCustomer Precios por cliente.
GET /PriceList Listas de precios.
GET /Product Artículos (composición, comentarios y escalas).
GET /ProductAssistant Asistente de ventas: busca por descripción o sugiere complementarios y sustitutos.
GET /ProductComplementaries Artículos complementarios del artículo consultado.
GET /ProductSemanticSearch Búsqueda de artículos por descripción, comparando por significado.
GET /ProductsFolder Clasificador de artículos: artículos en carpetas.
GET /ProductsFolderClassifier Clasificador de artículos: carpetas.
GET /ProductsRelation Clasificador de artículos: relaciones.
GET /ProductSubstitutes Artículos sustitutos del artículo consultado.
GET /Publications Publicaciones (relación artículo de la tienda ↔ artículo de Tango).
GET /SaleCondition Condiciones de venta.
GET /Scale Escalas.
GET /Seller Vendedores.
GET /Stock Saldos de stock por artículo/depósito/sucursal.
GET /StockGroupByProduct Saldos de stock agrupados por artículo.
GET /Store Sucursales.
GET /Transport Transportes.
GET /ValueScale Valores de escala.
GET /Warehouse Depósitos (incluye depósitos de stock centralizado).

Instalación

Versiones soportadas

Volver al índice

La API de Tango eCommerce está disponible a partir de la versión Delta 6 de Tango Gestión o Tango Punto de Venta Argentina.

Importante: el requerimiento mínimo de TLS es la versión 1.2. No se da soporte a TLS 1.0 ni TLS 1.1. Esto aplica tanto a las llamadas a la API como al servidor del webhook de notificaciones.

Requisitos previos

Volver al índice

Para poder consumir la API, la empresa debe tener completada la puesta en marcha de eCommerce en Tango:

  • El producto eCommerce activo en Tango Billing.
  • La empresa vinculada con Tango Connect y con eCommerce.
  • Una Cuenta de Integración API creada. Su nombre es el valor que se envía en el parámetro ?Cuenta= de los POST (y opcionalmente como filtro en los GET Order, Invoices y Publications).

Generalidades

Volver al índice

  • La API admite órdenes únicamente en moneda corriente.

  • Los datos de importes y precios se expresan con hasta 2 decimales, usando el punto (.) como separador decimal. Informar una cantidad mayor de decimales no provoca el rechazo de la orden, pero el tratamiento difiere según el dato:

    • Los importes de los pagos (Payments.Total y CashPayments.PaymentTotal) se redondean a 2 decimales antes de registrarse.
    • El resto de los datos (precios, cantidades, totales, descuentos y recargos) se registra tal como se informa.
    • Las fórmulas de validación de Total y PaidTotal comparan los valores redondeados a 2 decimales.

    El criterio de redondeo funciona igual que el redondeo tradicional, salvo cuando el valor queda exactamente a mitad de camino (la parte descartada es exactamente 5): en ese caso, en lugar de redondear siempre hacia arriba, el segundo decimal queda en el valor par más cercano. Ejemplos: 10.126 → 10.13 y 10.124 → 10.12 (igual que el redondeo tradicional); 10.125 → 10.12 (el 2 ya es par) y 10.135 → 10.14 (el 3 sube al par 4).

  • A la API se accede a través de Tango Connect: la URL base tiene el formato https://{llave}.connect.axoft.com/api/eCommerce, donde {llave} es el número de llave del sistema Tango reemplazando la barra / por un guion - (por ejemplo, la llave 000000/000 corresponde a https://000000-000.connect.axoft.com/api/eCommerce).

Acceso a la API

Volver al índice

Para consumir la API sólo necesita las credenciales de acceso. Lo que debe estar configurado en Tango se lista en Requisitos previos.

Credenciales

Todas las llamadas a la API se autentican con dos headers:

Header Contenido Dónde obtenerlo
ApiAuthorization Token de desarrollador de Tango. Menú de usuario › Desarrollador › botón Generar. Copie el "Token de desarrollador".
Company IdEmpresa: identificador interno de la empresa vinculada en Tango. En la columna IDEmpresa de la tabla Empresa de la base de datos de diccionario

Ejemplo de headers:

ApiAuthorization: D3D5444E-B8DE-455A-91DE-4960B7110FC9
Company: 1

Ambos headers son obligatorios en todos los recursos (incluidos los GET). En ausencia de cualquiera de los dos, o en caso de que su valor sea vacío, obtendrá como respuesta un código de error 401.

Verificar la conexión (Dummy)

Para validar las credenciales, realice un POST (sin cuerpo) al recurso Dummy:

POST https://{llave}.connect.axoft.com/api/eCommerce/Dummy

Respuesta cuando el acceso es válido:

{
  "Status": 0,
  "Message": "Valid ApiAuthorization",
  "Data": null,
  "isOk": true
}

Cómo interpretar la respuesta

Volver al índice

Formato de respuesta y paginación

Todas las respuestas GET usan el mismo formato, salvo Dummy y los recursos de AI, que devuelven una sola página con su propio formato. Los datos se entregan de forma paginada:

{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": true
  },
  "Data": [ /* registros del recurso */ ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}
Campo Descripción
Paging.PageNumber Número de página actual.
Paging.PageSize Tamaño de página solicitado.
Paging.MoreData Indica si existe una página siguiente con datos.
Data Lista con los registros del recurso. Presente en toda respuesta con succeeded: true (un GET sin resultados devuelve []). En las respuestas de error con succeeded: false la clave puede no emitirse; consulte succeeded antes de leerla.
PagingError Detalle de error de paginación; null cuando la paginación es válida.
OrderError Detalle de error específico de órdenes (ver GET Order); null en el resto de los casos.
succeeded true si la operación fue exitosa; es el campo a consultar para conocer el resultado de la operación.
Message Mensaje de la operación (string único). null cuando no hay mensaje; en un GET sin resultados contiene "No se encontraron valores".

Un GET sin resultados responde 200 con la lista vacía:

{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [],
  "PagingError": null,
  "Message": "No se encontraron valores",
  "OrderError": null,
  "succeeded": true
}

Importante — fin de la paginación: la última página se detecta con Paging.MoreData: false (o Data vacío). Si migra desde la API de Tango Tiendas, el terminador del bucle de sincronización cambió: consúltelo en Migración.

Parámetros de paginación, comunes a todos los GET. Los recursos de AI devuelven una sola página y tienen su propio tope de PageSize.

Parámetro Obligatorio Descripción
PageNumber No Página solicitada. Por defecto 1.
PageSize No Cantidad de ítems por página. Por defecto 50, máximo 5000.

Ejemplo:

https://{llave}.connect.axoft.com/api/eCommerce/Currency?PageNumber=1&PageSize=500

Si PageNumber o PageSize son menores o iguales a 0, la respuesta reemplaza Paging/Data por PagingError (los recursos de AI responden 400 con succeeded y Message, sin PagingError):

{
  "PagingError": {
    "ErrorNumber": "Invalid page number",
    "ErrorSize": "Invalid page size"
  },
  "Message": null,
  "OrderError": null,
  "succeeded": false
}

Códigos de estado HTTP

Situación HTTP Cómo se informa
GET/POST exitoso 200 succeeded: true
GET sin resultados 200 succeeded: true, Message: "No se encontraron valores"
Datos inválidos o con formato incorrecto (GET o POST), incluido un tipo inválido en la query de un GET, p. ej. PageSize=abc 400 Cuerpo JSON con el detalle por campo en la propiedad errors (ver ejemplo)
Falta un header de autenticación (o viene vacío), o el token es inválido 401 Sin cuerpo; sólo el código HTTP indica el error
Ruta inexistente bajo Api/eCommerce 404 Message: "No HTTP resource was found that matches the request URI '...'." (única clave del cuerpo)
Método HTTP no soportado por el recurso (por ejemplo, DELETE a cualquier recurso, o GET a /Dummy, que es POST) 405 Sin cuerpo; sólo el código HTTP indica el error

Los recursos de AI cambian el cuerpo del 400 y agregan estas respuestas:

Situación HTTP Cómo se informa
Tango Billing rechaza la consulta, por ejemplo cuando el saldo es insuficiente, se superó el presupuesto mensual o la opción de eCommerce está inactiva 200 succeeded: false y el mensaje que devuelve Tango Billing
Datos inválidos 400 succeeded: false y Message con la causa, sin la propiedad errors. Si hay varios datos inválidos, informa sólo el primero
La base de la empresa no tiene SQL Server 2025, en los recursos que usan vectores 409 succeeded: false, Message: "Este proceso requiere SQL Server 2025 o superior. Por favor, actualice la versión de SQL Server."
Se alcanzó el límite de consultas simultáneas 429 succeeded: false, Message: "El servicio está procesando otras consultas. Reintente en unos instantes.". El límite se comparte entre todas las empresas de la instalación. La respuesta no incluye el header Retry-After
Venció la espera máxima de las llamadas al modelo 504 succeeded: false, Message: "El servicio no respondió a tiempo. Reintente en unos instantes."

Ejemplo del cuerpo de un 400 por datos inválidos (orden enviada sin Customer.Email):

{
  "errors": {
    "Customer.Email": [
      "The Email field is required."
    ]
  }
}

Alcance del 404: el cuerpo JSON del 404 se devuelve sólo para rutas bajo el prefijo exacto Api/eCommerce.

Dónde leer el detalle del error de negocio: el mensaje funcional viene en Message (string único, p. ej. "ApertureValidationException: Order total doesn't add up."). Para los errores de órdenes puntuales, vea OrderError.

Recepción de órdenes

Volver al índice

URL del servicio para enviar una orden (POST):

https://{llave}.connect.axoft.com/api/eCommerce/Order?Cuenta={NombreCuenta}

El parámetro Cuenta es obligatorio y corresponde al nombre de la Cuenta de Integración API.

La orden se envía en el cuerpo en formato JSON. Consulte:

Al reenviar una orden con un OrderID ya existente, se interpreta como modificación (idempotencia por OrderID). La orden sólo puede modificarse mientras esté en estado RECIBIDA (o EN PROCESO/FINALIZADA/FINALIZADA* si se trata de una cancelación y únicamente actualiza el estado a CANCELADA). El CustomerID no puede cambiar entre modificaciones.

La respuesta usa la forma Status/Message/Data/isOk (la misma que devuelve Dummy), más los campos succeeded y OrderError. En caso de éxito (Status: 0, isOk: true; Data viene siempre y es null en la orden individual):

{
  "Status": 0,
  "Data": null,
  "isOk": true,
  "Message": "Order ORD-1 in process",
  "OrderError": null,
  "succeeded": true
}

Ante un error de negocio, la respuesta indica Status: 1, isOk: false, succeeded: false y el texto real de la validación en Message. Si el nombre enviado en Cuenta no corresponde a ninguna Cuenta de Integración API, la respuesta usa esa misma forma con Message: "<cuenta> is not registered.". Ante un error de formato o un campo obligatorio ausente (por ejemplo, falta Customer.Email), la respuesta es 400.

Notificaciones (webhooks)

Volver al índice

Las notificaciones se habilitan durante la puesta en marcha de la Cuenta de Integración API, indicando una URL de notificaciones y los eventos a recibir. El receptor debe exponer un endpoint POST de una web API accesible por HTTPS (TLS 1.2 o superior).

Se notifican los siguientes eventos:

Evento Tópico Cuándo se envía
Orden observada OrderObserved La orden fue recibida pero quedó observada (por ejemplo, una lista de precios inexistente).
Orden procesada OrderProcessed Se generó el pedido a partir de la orden.
Orden rechazada OrderRejected La orden fue rechazada.
Orden facturada OrderBilled Se facturó el pedido generado.
Orden cancelada OrderCancelled La orden fue cancelada.
Factura disponible InvoiceFile Hay un comprobante electrónico en PDF disponible.
Actualización de precios PriceProductUpdate Cambió el precio de un artículo.
Actualización de saldos de stock StockProductUpdate Cambió el saldo de stock de un artículo (incluye saldos centralizados).

El cuerpo de la notificación se envía como JSON (Content-Type: application/json) con los datos de la orden o novedad notificada.

Formato de JSON de notificación:

El cuerpo de cada notificación es un objeto JSON con tres propiedades: Topic (el tópico del evento, ver tabla anterior), Resource (el identificador del recurso afectado) y Message (un texto descriptivo, que puede venir vacío). Ejemplos según el tipo de evento:

{
  "Topic": "OrderObserved",
  "Resource": "ORD-1",
  "Message": "Lista de precios inexistente"
}
{
  "Topic": "InvoiceFile",
  "Resource": "ORD-1",
  "Message": ""
}
{
  "Topic": "PriceProductUpdate",
  "Resource": "1",
  "Message": "Actualización de Precio"
}
{
  "Topic": "StockProductUpdate",
  "Resource": "1",
  "Message": "Actualización de Saldo"
}

Importante — sensibilidad a mayúsculas: los nombres de las propiedades (Topic, Resource, Message) y los valores de Topic distinguen mayúsculas de minúsculas; respételos tal como figuran.

Aclaración — significado de Resource según el tópico:

  • En los tópicos de orden (OrderObserved, OrderProcessed, OrderRejected, OrderBilled, OrderCancelled, InvoiceFile), Resource es el identificador de la orden (OrderID).
  • En PriceProductUpdate, Resource es el Id del registro de precio modificado.
  • En StockProductUpdate, Resource es el Id del registro de saldo modificado.

Órdenes por lote

Volver al índice

URL del servicio para enviar órdenes en lote (POST):

https://{llave}.connect.axoft.com/api/eCommerce/Order/Batch?Cuenta={NombreCuenta}

El cuerpo contiene una lista de órdenes (con el mismo formato que el POST Order):

{
  "OrderBatch": [
    {
      "OrderID": "1",
      "OrderNumber": "1",
      "...": "..."
    },
    {
      "OrderID": "2",
      "OrderNumber": "2",
      "...": "..."
    }
  ]
}

El número máximo de órdenes por lote es 25. Un lote inválido se rechaza con Status: 1, isOk: false, succeeded: false y el Message correspondiente: "OrderBatch must contain at least one order" (lote vacío o cuerpo sin la clave OrderBatch), "The number of orders exceeds the batch limit of 25" (lote que supera el máximo permitido) o "<cuenta> is not registered" (la Cuenta de Integración API se valida una sola vez, antes del lote: si no existe, el lote entero se rechaza sin procesar ninguna orden). Superados esos controles, el lote se procesa orden por orden: si una falla, el resto continúa (Status: 0 e isOk: true, y el resultado por orden viaja en Data):

{
  "Status": 0,
  "Data": [
    {
      "OrderID": "1,3",
      "Processed": true,
      "ValidationException": null
    },
    {
      "OrderID": "2",
      "Processed": false,
      "ValidationException": "ApertureValidationException: ..."
    }
  ],
  "isOk": true,
  "Message": "batch processed",
  "OrderError": null,
  "succeeded": true
}
  • Las órdenes procesadas correctamente se consolidan en un único ítem con Processed: true y los OrderID separados por coma. Ese ítem consolidado es siempre el primer elemento de Data, incluso cuando ninguna orden se procesa (en ese caso viaja con OrderID: "").
  • Cada orden con error genera su propio ítem con Processed: false y el detalle en ValidationException.

Preguntas frecuentes

Volver al índice

  • ¿Cómo autentico las llamadas?

    Con los headers ApiAuthorization (Token de desarrollador) y Company (IdEmpresa) en todas las llamadas. Para los POST de órdenes, además el parámetro Cuenta en la URL. Ver Credenciales.

  • ¿Dónde se envían los datos de facturación para las órdenes?

    El nombre del receptor se toma de la Razón Social (BusinessName) informada en la orden; si no se informa, se toma de los campos que corresponden al apellido y nombre (LastName / FirstName). Cuando la orden trae el número de CUIL / CUIT o DNI, se consulta AFIP para completar los datos fiscales del receptor (condición de IVA, tipo y número de documento); la razón social registrada en AFIP sólo se utiliza cuando en la orden no se informó ningún nombre.

Novedades del JSON de la orden

Volver al índice

Doble unidad de medida (DUM)

Un artículo con doble unidad de medida maneja dos unidades de stock:

  • Stock 1 (precios y costos): unidad en la que se expresan los precios, los costos y los saldos.
  • Stock 2: segunda unidad en la que también se expresa el saldo.
  • UM de control de stock: determina cuál de las dos unidades controla la disponibilidad y compromete el stock.
  • Equivalencia: cuántas unidades de stock 1 equivalen a una unidad de stock 2.

Ejemplo: se venden hormas de queso con Unidad de stock 1 = Kilos, Unidad de stock 2 = Horma y equivalencia = 2 (una horma equivale a 2 kilos).

Para un artículo con doble unidad de medida, el campo SelectMeasureUnit de cada ítem indica en qué unidad se expresan la cantidad y el precio:

Valor Unidad
V Ventas (valor por defecto si no se informa).
P Stock 1 (precios y costos).
S Stock 2.

Para un artículo simple se puede indicar P (Stock 1). El campo MeasureCode indica el código de medida con el que se generará el pedido.

Ejemplo: DUM informando unidad de Ventas

Artículo con Unidad de stock 1 = KILOGRAMOS, Unidad de stock 2 = UNI, equivalencia = 3 kilos por unidad.

{
  "OrderItems": [
    {
      "ProductCode": "1000",
      "SKUCode": "ART_DOBLEUNIDAD",
      "Description": "Artículo de doble unidad de medida",
      "Quantity": 1.0,
      "UnitPrice": 30.0,
      "MeasureCode": "UNI",
      "SelectMeasureUnit": "V"
    }
  ]
}

En este caso se informa la unidad de Ventas (SelectMeasureUnit: "V"), por lo que UnitPrice corresponde al precio de venta; al generar el pedido se expresará en la unidad de stock 1.

Ejemplo: DUM informando unidad de Stock 1

Mismo artículo: Unidad de stock 1 = KILOGRAMOS, Unidad de stock 2 = UNI, equivalencia = 3 kilos por unidad.

{
  "OrderItems": [
    {
      "ProductCode": "1000",
      "SKUCode": "ART_DOBLEUNIDAD",
      "Description": "Artículo de doble unidad de medida",
      "Quantity": 1.0,
      "UnitPrice": 10.0,
      "MeasureCode": "KILOGRAMOS",
      "SelectMeasureUnit": "P"
    }
  ]
}

En este caso se informa la unidad de Stock 1 (SelectMeasureUnit: "P"), por lo que UnitPrice corresponde al precio por unidad de stock 1 (kilogramo).

Condición de venta, transporte y pagos

  • Condición de venta (SaleConditionCode): si es distinta de Contado, es posible que al valor de la factura se le apliquen cargos propios de la condición (por ejemplo, intereses a 30/60/90 días).
  • Transporte: si la condición de venta es Contado, se valida que el transporte informado no tenga recargo (SurchargePercentage = 0).
  • Pagos: sólo pueden informarse CashPayments / Payments cuando la condición de venta es Contado y la orden no fue acordada con el vendedor. Si la orden fue acordada con el vendedor (AgreedWithSeller: true), la condición de venta debe ser Contado y no debe informarse ningún pago.

Renglones con importes negativos

La API acepta los mismos signos que el circuito manual de Pedidos de Tango. Un renglón puede tener precio unitario negativo con cantidad positiva, o cantidad negativa con precio positivo, y el precio unitario puede ser 0. Lo que no se admite es una cantidad en 0, ni que la cantidad y el precio unitario sean negativos a la vez en el mismo renglón (el importe del renglón quedaría positivo).

Cantidad Precio unitario Resultado
Positiva Positivo o 0 Se acepta.
Positiva Negativo Se acepta.
Negativa Positivo o 0 Se acepta.
Negativa Negativo Se rechaza: OrderItems - Quantity and UnitPrice can't be negative at the same time.
0 (o ausente) Cualquiera Se rechaza: OrderItems - Quantity must be different from zero.

La restricción es por renglón, no por orden: una misma orden puede combinar un renglón con cantidad negativa y otro con precio negativo.

Como consecuencia, el Total de la orden puede ser negativo cuando los renglones negativos superan a los positivos. En ese caso el control de PaidTotal contra Total no aplica (ver fórmulas de validación).

Ejemplo: orden con un renglón negativo
{
  "Total": 6000.0,
  "ValidateTotalWithItems": true,
  "OrderItems": [
    {
      "ProductCode": "203",
      "SKUCode": "0100200659",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "Quantity": 1.0,
      "UnitPrice": 10000.0
    },
    {
      "ProductCode": "500",
      "SKUCode": "0100200700",
      "Description": "BONIFICACION",
      "Quantity": 1.0,
      "UnitPrice": -4000.0
    }
  ]
}

El total se calcula con la fórmula habitual, respetando los signos: 10000 + (-4000) = 6000.

Datos del JSON

Volver al índice

Los importes numéricos se expresan con hasta 2 decimales, usando el punto como separador. Informar más de 2 decimales no hace que la orden se rechace: los importes de los pagos (Payments.Total y CashPayments.PaymentTotal) se redondean a 2 decimales, y todos los demás datos se registran con los decimales informados. El criterio de redondeo se describe en Generalidades.

Tópico principal (obligatorio)

Campo Requerido Tipo Descripción / Validación
OrderID Sí Alfanumérico (≤200) Identificador único de la orden. No puede ser vacío. Reenviar el mismo OrderID modifica la orden.
OrderNumber Sí Alfanumérico (≤200) Número con el que se identifica la orden. No puede ser vacío.
Date Sí Datetime Fecha de la orden. No puede ser anterior a 30 días de la fecha actual ni a la fecha de inicio configurada en la cuenta.
Total Sí Numérico Importe total de la orden. Admite valores negativos (por ejemplo, cuando los renglones negativos superan a los positivos).
TotalDiscount No Numérico (≥0) Descuento total de la operación.
PaidTotal No Numérico (≥0) Importe total pagado.
FinancialSurcharge No Numérico (≥0) Recargo financiero.
WarehouseCode No Alfanumérico (≤10) Código de depósito.
SellerCode No Alfanumérico (≤10) Código de vendedor.
TransportCode No Alfanumérico (≤10) Código de transporte.
SaleConditionCode No Entero (0–99) Condición de venta.
PriceListNumber No Entero Número de lista de precios.
InvoiceCounterfoil No Entero (0–9999) Talonario de facturación.
OrderCounterfoil No Entero (0–9999) Talonario de pedido.
AgreedWithSeller No Lógico Indica si el pago se acuerda con el vendedor.
ValidateTotalWithItems No Lógico Si es true, valida Total según la fórmula.
ValidateTotalWithPaidTotal No Lógico Si es true, valida además que PaidTotal no exceda Total (ver fórmulas).
Comment No Alfanumérico (≤280) Comentario del comprador.
CancelOrder No Lógico Indica que la orden está cancelada.
CancelReason No Alfanumérico Motivo de cancelación (sólo si CancelOrder = true).
CancelDate Condicional Datetime Requerido si CancelOrder = true; no puede ser anterior a Date.
Customer Sí Tópico Datos del cliente.
OrderItems Sí Lista Al menos un ítem.
Shipping No Tópico Datos de envío.
CashPayments No Lista Pagos en efectivo/transferencia/pasarelas.
Payments No Lista Pagos con tarjeta.

Fórmulas de validación

Total     = ∑[ (UnitPrice − (UnitPrice / 100 × DiscountPercentage)) × Quantity ]
            + Shipping.ShippingCost + FinancialSurcharge − TotalDiscount

PaidTotal = ∑(Payments.Total) + ∑(CashPayments.PaymentTotal)

Total se valida contra su fórmula sólo si ValidateTotalWithItems = true. La igualdad de PaidTotal con la suma de los pagos (∑Payments.Total + ∑CashPayments.PaymentTotal) se valida siempre; en particular, informar un PaidTotal distinto de 0 sin detallar pagos hace que la orden se rechace. ValidateTotalWithPaidTotal agrega además el control de que PaidTotal no supere Total, que sólo aplica cuando Total es mayor o igual a cero: con un total negativo la comparación se omite, porque PaidTotal no admite valores negativos y siempre resultaría mayor.

Tópico Customer (obligatorio)

Campo Requerido Tipo Descripción
CustomerID Sí Numérico (>0) Identificador del cliente. No puede cambiar en modificaciones.
Code No Alfanumérico Código del cliente en Tango.
DocumentType Sí Alfanumérico Código de tipo de documento. Ver Tipo de Documento.
DocumentNumber No Alfanumérico Número de documento sin símbolos.
IVACategoryCode Sí Alfanumérico Categoría de IVA. Ver Condición Fiscal.
User Sí Alfanumérico (≤200) Usuario de la tienda.
Email Sí Alfanumérico (≤255) Correo electrónico.
ProvinceCode Sí Alfanumérico (≤4) Código AFIP de la provincia. Ver Provincias.
FirstName No Alfanumérico (≤200) Nombre.
LastName No Alfanumérico Apellido.
BusinessName No Alfanumérico Razón social.
Street / HouseNumber / Floor / Apartment / City / PostalCode No Alfanumérico Domicilio (el sistema lo compone en un único domicilio).
Address No Alfanumérico Domicilio ya compuesto. Si se informa, se usa tal cual como domicilio del comprador en lugar de componerlo desde Street/HouseNumber/etc.
PhoneNumber1 / PhoneNumber2 / MobilePhoneNumber No Alfanumérico Teléfonos.
BusinessAddress No Alfanumérico Domicilio comercial.
NumberListPrice No Entero Número de lista de precios del cliente.
PayInternalTax No Lógico Indica si se liquidan impuestos internos al comprador.

Cómo se relaciona con el cliente habitual

Si en el proceso Parámetros de eCommerce está activada la opción Busca cliente habitual, la orden se asocia a un cliente habitual de Tango según el primer criterio que arroje coincidencia, en este orden:

  1. ABM Clientes — solapa principal: código de cliente (Code), luego tipo y número de documento, luego correo electrónico.
  2. ABM Clientes — solapa contactos (si la solapa principal no arrojó coincidencias): código de cliente, tipo y número de documento, correo electrónico y, por último, usuario de la tienda (User).

Para la comparación de documento, CUIT y CUIL se aceptan indistintamente. Si ningún criterio coincide, el pedido se genera con el cliente ocasional.

Tópico OrderItems (obligatorio, al menos un registro)

Campo Requerido Tipo Descripción
ProductCode Sí Alfanumérico (≤200) Código del artículo de la publicación.
SKUCode No Alfanumérico (≤40) Código de artículo, sinónimo o código de barras de Tango. Establece/actualiza la relación de la publicación (ProductCode) con el artículo de Tango.
VariantCode No Alfanumérico (≤200) Código de la combinación (escala).
Description Sí Alfanumérico (≤400) Descripción del artículo.
VariantDescription No Alfanumérico (≤400) Descripción de la variante.
Quantity Sí Numérico, distinto de 0 Cantidad. Admite negativos. Ver renglones con importes negativos.
UnitPrice Sí Numérico Precio unitario. Admite 0 y negativos. Ver renglones con importes negativos.
DiscountPercentage No Numérico (0–99,99) Porcentaje de descuento.
SelectMeasureUnit No Alfanumérico (1) Unidad de medida seleccionada: V, P o S (por defecto V). Ver DUM.
MeasureCode No Alfanumérico Código de medida con el que se genera el pedido.
WarehouseCode No Alfanumérico (≤10) Código de depósito del renglón. Si se informa, el renglón del pedido se genera con ese depósito.

Cálculo del precio por renglón: (UnitPrice − (UnitPrice / 100 × DiscountPercentage)) × Quantity.

Tópico Shipping (opcional)

Si se informa este tópico, ShippingID pasa a ser obligatorio (numérico y mayor a 0) y ProvinceCode es obligatorio salvo que se informe ShippingCode (una dirección de entrega existente del cliente).

Campo Requerido Tipo Descripción
ShippingID Condicional Numérico (>0) Identificador del envío. Requerido si se informa Shipping.
ShippingCode No Alfanumérico (≤40) Código de la dirección de entrega.
ShippingCost No Numérico Costo de envío.
Street / HouseNumber / Floor / Apartment / City / PostalCode No Alfanumérico Domicilio de entrega.
ProvinceCode Condicional Alfanumérico (≤4) Código AFIP de la provincia. Requerido si se informa Shipping sin ShippingCode.
PhoneNumber1 / PhoneNumber2 No Alfanumérico (≤30) Teléfonos.
DeliversMonday … DeliversSunday No Alfanumérico (1) Días de entrega: S / N (por defecto N).
DeliveryHours No Alfanumérico (≤100) Hora de entrega.
DeliveryDate No Datetime Fecha de entrega. No puede ser anterior a Date.

Tópico CashPayments (opcional) — pagos en efectivo/transferencia/pasarelas

Campo Requerido Tipo Descripción
PaymentID Sí Numérico (>0, hasta 50 dígitos) Identificador del pago. Único en toda la orden.
PaymentMethod Sí Alfanumérico (≤3) Código de forma de cobro. Ver Formas de Pago.
PaymentTotal Sí Numérico (≥0) Total del pago. Debe cuadrar con PaidTotal y la suma de pagos (ver fórmulas).

Tópico Payments (opcional) — pagos con tarjeta

Campo Requerido Tipo Descripción
PaymentId Sí Numérico (>0) Identificador del pago. Único en toda la orden.
TransactionDate Sí Datetime Fecha del pago. No anterior a Date.
Installments Sí Numérico (≥1) Cantidad de cuotas.
InstallmentAmount Sí Numérico (>0) Importe por cuota.
Total Sí Numérico (>0) Total del pago.
CardCode Sí Alfanumérico Código de la tarjeta de crédito (módulo Tesorería).
CardPlanCode Sí Alfanumérico Plan de la tarjeta.
VoucherNo Sí Numérico (0–99999999) Número de cupón.
AuthorizationCode No Alfanumérico Código de autorización.
TransactionNumber No Alfanumérico Número de transacción.
CardPromotionCode No Alfanumérico Código de promoción.

Tablas de referencia

Volver al índice

Tipo de Documento
Código Descripción
80 CUIT
86 CUIL
91 CI extranjera
94 Pasaporte
96 DNI
99 Sin identificar / venta global diaria

Son los tipos de documento habilitados para el ingreso de comprobantes en Tango (IVA_TIPO_DOCUMENTO.HABILITADO_PARA_INGRESO = 'S'). Un código no habilitado (por ejemplo, 89 - LE) se rechaza con Incorrect value - Field: DocumentType.

Provincias
Código Descripción
0 CIUDAD AUTONOMA BUENOS AIRES
1 BUENOS AIRES
2 CATAMARCA
3 CORDOBA
4 CORRIENTES
5 ENTRE RIOS
6 JUJUY
7 MENDOZA
8 LA RIOJA
9 SALTA
10 SAN JUAN
11 SAN LUIS
12 SANTA FE
13 SANTIAGO DEL ESTERO
14 TUCUMAN
16 CHACO
17 CHUBUT
18 FORMOSA
19 MISIONES
20 NEUQUEN
21 LA PAMPA
22 RIO NEGRO
23 SANTA CRUZ
24 TIERRA DEL FUEGO

Condición Fiscal
Código Descripción
CF CONSUMIDOR FINAL
EX EXENTO
EXE EXENTO OPERACIÓN EXPORTACIÓN
INR NO RESPONSABLE
RI RESPONSABLE INSCRIPTO
RS RESPONSABLE MONOTRIBUTISTA
RSS RESPONSABLE MONOTRIBUTISTA SOCIAL
PCE PEQUEÑO CONTRIBUYENTE EVENTUAL
PCS PEQUEÑO CONTRIBUYENTE EVENTUAL SOCIAL
SNC SUJETO NO CATEGORIZADO
INA IVA NO ALCANZADO

Formas de Pago

Los códigos disponibles dependen de la configuración de formas de cobro de Tango:

Código Descripción
A01 … A10 Formas de cobro Web API 01 a 10
MPA MercadoPago Argentina
PPA PayPal Argentina
PUA PayU Argentina
TPA Todo Pago Argentina

Ejemplos de JSON

Volver al índice

Orden con condición de venta Contado
{
  "Date": "2026-02-14T00:00:00",
  "Total": 8523.0,
  "TotalDiscount": 77.0,
  "PaidTotal": 8523.0,
  "FinancialSurcharge": 200.0,
  "WarehouseCode": "2",
  "SellerCode": "2",
  "TransportCode": "01",
  "SaleConditionCode": 1,
  "InvoiceCounterfoil": 1,
  "OrderID": "75906",
  "OrderNumber": "75906",
  "ValidateTotalWithPaidTotal": true,
  "Customer": {
    "CustomerID": 227060905,
    "DocumentType": "80",
    "DocumentNumber": "11111111111",
    "IVACategoryCode": "CF",
    "User": "ADMIN",
    "Email": "api@axoft.com",
    "FirstName": "Carlos",
    "LastName": "Perez",
    "BusinessName": "Empresa",
    "Street": "Cerrito",
    "HouseNumber": "1186",
    "City": "CABA",
    "ProvinceCode": "0",
    "PostalCode": "1122"
  },
  "OrderItems": [
    {
      "ProductCode": "203",
      "SKUCode": "0100200659",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "Quantity": 1.0,
      "UnitPrice": 7700.0,
      "DiscountPercentage": 0.0
    }
  ],
  "Shipping": {
    "ShippingID": 71906,
    "Street": "9 de Julio",
    "HouseNumber": "1186",
    "City": "CABA",
    "ProvinceCode": "0",
    "PostalCode": "1122",
    "ShippingCost": 400.0,
    "DeliversMonday": "S"
  },
  "CashPayments": [
    {
      "PaymentID": 38566912,
      "PaymentMethod": "A02",
      "PaymentTotal": 423.0
    }
  ],
  "Payments": [
    {
      "PaymentId": 38566913,
      "TransactionDate": "2026-02-14T00:00:00",
      "Installments": 1,
      "InstallmentAmount": 8100.0,
      "Total": 8100.0,
      "CardCode": "DI",
      "CardPlanCode": "1",
      "VoucherNo": 48
    }
  ]
}
Orden con condición de venta Cuenta corriente
{
  "Date": "2026-05-28T00:00:00",
  "Total": 8400.0,
  "PaidTotal": 0.0,
  "WarehouseCode": "2",
  "SellerCode": "2",
  "TransportCode": "02",
  "SaleConditionCode": 3,
  "InvoiceCounterfoil": 2,
  "OrderID": "75907",
  "OrderNumber": "75907",
  "ValidateTotalWithPaidTotal": false,
  "Customer": {
    "CustomerID": 227060905,
    "Code": "010010",
    "DocumentType": "80",
    "DocumentNumber": "11111111111",
    "IVACategoryCode": "CF",
    "User": "ADMIN",
    "Email": "api@axoft.com",
    "FirstName": "Carlos",
    "LastName": "Perez",
    "ProvinceCode": "0"
  },
  "OrderItems": [
    {
      "ProductCode": "203",
      "SKUCode": "0100200659",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "Quantity": 1.0,
      "UnitPrice": 8400.0
    }
  ],
  "CashPayments": [],
  "Payments": []
}
Orden con código de dirección de entrega
{
  "Date": "2026-05-28T00:00:00",
  "Total": 8800.0,
  "PaidTotal": 0.0,
  "WarehouseCode": "2",
  "SellerCode": "2",
  "TransportCode": "02",
  "SaleConditionCode": 3,
  "OrderID": "75908",
  "OrderNumber": "75908",
  "ValidateTotalWithPaidTotal": false,
  "Customer": {
    "CustomerID": 227060905,
    "Code": "010010",
    "DocumentType": "80",
    "DocumentNumber": "11111111111",
    "IVACategoryCode": "CF",
    "User": "ADMIN",
    "Email": "api@axoft.com",
    "ProvinceCode": "0"
  },
  "OrderItems": [
    {
      "ProductCode": "203",
      "SKUCode": "0100200659",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "Quantity": 1.0,
      "UnitPrice": 8400.0
    }
  ],
  "Shipping": {
    "ShippingID": 71906,
    "ShippingCode": "PRINCIPAL",
    "ShippingCost": 400.0
  },
  "CashPayments": [],
  "Payments": []
}

En este caso se informa Shipping.ShippingCode y no hace falta completar el resto del domicilio: si el código existe entre las direcciones de entrega del cliente habitual, el pedido se genera con esa dirección; si no existe, se utiliza la dirección de entrega habitual del cliente. Las direcciones de entrega se consultan con GET /Customer.

Orden con cliente habitual y lista de precios
{
  "Date": "2026-02-14T00:00:00",
  "Total": 7700.0,
  "PaidTotal": 7700.0,
  "WarehouseCode": "2",
  "SellerCode": "2",
  "TransportCode": "01",
  "SaleConditionCode": 1,
  "PriceListNumber": 2,
  "OrderID": "75909",
  "OrderNumber": "75909",
  "ValidateTotalWithPaidTotal": true,
  "Customer": {
    "CustomerID": 227060905,
    "Code": "010010",
    "DocumentType": "80",
    "DocumentNumber": "11111111111",
    "IVACategoryCode": "CF",
    "PayInternalTax": false,
    "User": "ADMIN",
    "Email": "api@axoft.com",
    "ProvinceCode": "0"
  },
  "OrderItems": [
    {
      "ProductCode": "203",
      "SKUCode": "0100200659",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "Quantity": 1.0,
      "UnitPrice": 7700.0
    }
  ],
  "CashPayments": [
    {
      "PaymentID": 38566912,
      "PaymentMethod": "A02",
      "PaymentTotal": 7700.0
    }
  ],
  "Payments": []
}

En este caso se informa Customer.Code para enlazar la orden con el cliente habitual de Tango (ver cómo se relaciona con el cliente habitual) y PriceListNumber; el desglose impositivo del pedido se define según la configuración de esa lista de precios en Tango.

Consulta de datos

Volver al índice

Los recursos GET permiten consultar datos de Tango Gestión o Tango Punto de Venta, devolviendo el resultado paginado en el formato de respuesta descripto arriba. Todos se consumen sobre la misma base; por ejemplo:

GET https://{llave}.connect.axoft.com/api/eCommerce/Product?PageNumber=1&PageSize=100

Sincronización incremental: varios recursos aceptan un parámetro de fecha (UpdatedDate, DatePrice, LastUpdate) para obtener sólo los registros creados o modificados desde esa fecha. En Customer y Product, la comparación contra la fecha de alta es a nivel día: un corte con hora incluye también los registros dados de alta ese mismo día (la fecha de alta se registra sin hora). Los registros sin fecha de alta ni de modificación (datos históricos de Tango) no se devuelven al filtrar por UpdatedDate, cualquiera sea el corte; para obtenerlos, consulte el recurso sin ese parámetro. Envíe la fecha en hora local, con el formato AAAA-MM-DDTHH:MM:SS y sin sufijo de zona horaria.

Filtro filter: todos los GET aceptan el parámetro filter. Utilice los filtros nombrados de cada recurso; el operador de cada filtro se indica en la tabla de parámetros del recurso cuando no es la búsqueda exacta. Los recursos de AI ignoran filter.

Su comportamiento depende del recurso:

  • Búsqueda parcial (contiene la cadena indicada) en los recursos cuya clave es un código: Currency, Measure, Scale, Warehouse, ValueScale, Seller, Customer, Product, ArtPorSaldoStock, PriceByCustomer, StockGroupByProduct.
  • Parcial o exacta según UseEqual en Stock y DiscountByCustomer: parcial por defecto, búsqueda exacta con UseEqual=true.
  • Búsqueda exacta en los recursos cuya clave es numérica o un identificador: PriceList, Price, Store, Transport, SaleCondition, CounterFoil, los clasificadores (*Folder/*Relation/*FolderClassifier) y CurrencyExchangeRate.
  • En Order, Invoices y Publications filtra con búsqueda parcial sobre el identificador de orden / código de artículo de la tienda.

Nota sobre stock centralizado: si la empresa centraliza stock de varias sucursales y desea informar saldos centralizados, envíe Centraliza=true en Stock / StockGroupByProduct. De lo contrario, la consulta devuelve los saldos de la sucursal local (ver Consideraciones).

Recursos de consulta

Volver al índice


Estado de órdenes — GET /Order

Volver a recursos

Devuelve el estado de las órdenes recibidas. Si se superan 50 identificadores por consulta, la consulta entera se rechaza (succeeded: false) y el detalle vuelve en OrderError (ver más abajo).

Parámetro Tipo Descripción
OrderId string Filtra por identificador de orden.
FromDate / ToDate datetime Rango de fechas.
Status string Estado(s) de la orden. Admite varios valores separados por coma.
IncludeInvoices bool Incluye los datos de facturación. Por defecto true.
Cuenta string Cuenta de Integración API.
filter string Filtra por identificador de orden (búsqueda parcial).
Respuesta

Con IncludeInvoices=true, cada orden incluye los datos del comprobante:

{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "OrderId": "75906",
      "Date": "2026-02-14T00:00:00",
      "Status": "FACTURADA",
      "IncludeInvoices": true,
      "InvoiceType": "FAC",
      "InvoiceNumber": "0001-00001234",
      "InvoiceFileUrl": "https://.../factura.pdf",
      "InvoiceFileExpiration": "2026-03-14T00:00:00"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Con IncludeInvoices=false, cada orden trae sólo OrderId, Date, Status e IncludeInvoices. InvoiceFileExpiration es null cuando la orden no tiene comprobante.

Si alguno de los OrderId consultados no existe, el detalle vuelve en OrderError con los identificadores afectados, junto con las órdenes encontradas (succeeded queda true: es un resultado parcial):

{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [ /* órdenes encontradas */ ],
  "PagingError": null,
  "Message": null,
  "OrderError": {
    "Orders": "75910,75911",
    "Message": "Unexisting Order ID"
  },
  "succeeded": true
}

Si se supera el límite de 50 identificadores por consulta, la consulta entera se rechaza sin ejecutarse. La respuesta conserva el formato de respuesta paginado — Paging con la paginación pedida, Data: [], PagingError: null — con succeeded: false y el detalle en OrderError: los identificadores enviados en Orders y Message: "The number of orders exceeds the limit of 50".

Comprobantes de facturación — GET /Invoices

Volver a recursos

Devuelve la relación entre cada orden y el comprobante electrónico asociado al pedido facturado de esa orden, incluyendo la URL de descarga del archivo PDF. Sólo se incluyen comprobantes electrónicos.

Parámetro Tipo Descripción
OrderId string Filtra por identificador de orden.
OrderNumber string Filtra por número de orden.
FromDate / ToDate datetime Rango de fechas.
Cuenta string Cuenta de Integración API.
filter string Filtra por identificador de orden (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "OrderID": "75906",
      "OrderNumber": "75906",
      "OrderDate": "2026-02-14T00:00:00",
      "InvoiceType": "FAC",
      "InvoiceNumber": "0001-00001234",
      "InvoiceFileUrl": "https://.../factura.pdf",
      "InvoiceFileExpiration": "2026-03-14T00:00:00"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Publicaciones — GET /Publications

Volver a recursos

Relación entre el artículo de la tienda y el artículo de Tango.

Parámetro Tipo Descripción
ProductCode string Código de artículo de la tienda.
SkuCode string Código de artículo de Tango.
VariantCode string Código de la variante (escala).
Cuenta string Cuenta de Integración API.
filter string Filtra por código de artículo de la tienda (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "ProductCode": "203",
      "Description": "LAVARROPAS AUTOM. MOD.BLUE",
      "VariantCode": "",
      "VariantDescription": "",
      "SkuCode": "0100200659"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Sucursales — GET /Store

Volver a recursos

Parámetro Tipo Descripción
FilterStoreNumber string Filtra por número de sucursal.

Recuerde: ProvinceCode es el código AFIP de la provincia (ver Provincias).

Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "StoreNumber": 1,
      "Description": "CASA CENTRAL",
      "Street": "",
      "Number": "",
      "Floor": "",
      "Apartment": "",
      "Tower": "",
      "Block": "",
      "City": "",
      "PostalCode": "",
      "ProvinceCode": "0",
      "Email": "",
      "WebPage": "",
      "Contact": "PRUEBA",
      "PhoneNumber1": "(011)3333-3333",
      "PhoneNumber2": ""
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Depósitos — GET /Warehouse

Volver a recursos

Devuelve tanto las sucursales (CentralizedStock: false) como los depósitos de stock centralizado (CentralizedStock: true).

Parámetro Tipo Descripción
FilterCode string Filtra por código de depósito.

El campo Id puede repetirse entre depósitos de distinto tipo; la clave estable es la combinación Code + CentralizedStock.

Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "Code": "1",
      "Description": "DEPOSITO CASA CENTRAL",
      "Disabled": false,
      "CentralizedStock": false
    },
    {
      "Id": 1,
      "Code": "10",
      "Description": "DEPOSITO CENTRALIZADO",
      "Disabled": false,
      "CentralizedStock": true
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Unidades de medida — GET /Measure

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de medida.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 2,
      "Code": "UNI",
      "Description": "Unidades",
      "Initials": "UN",
      "Quantity": 0,
      "UnitType": "",
      "AfipCode": "07",
      "AfipEquivalence": 1.0,
      "TransportCode": "",
      "TransportEquivalence": 0.0
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Escalas — GET /Scale

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de escala.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "Code": "01",
      "DescriptionScale": "COLOR",
      "NumberScale": 1
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Valores de escala — GET /ValueScale

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de escala.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "Code": "01",
      "CodeValue": "BL",
      "DescriptionValue": "BLANCO"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Artículos — GET /Product

Volver a recursos

Devuelve los artículos con su composición, comentarios y valores de escala. Sólo se muestran artículos que en Tango cumplan: perfil de Venta, Compra-Venta o Inhabilitado; tipo Simple, Fórmula o Kit fijo; y que no sean artículos Base.

Parámetro Tipo Descripción
FilterProductCode string Filtra por código de artículo (búsqueda exacta).
AlternativeCode string Filtra por sinónimo (búsqueda parcial).
BarCode string Filtra por código de barras (búsqueda parcial).
OnlyKit bool Sólo artículos Kit.
OnlyEnabled bool Sólo artículos habilitados.
UpdatedDate datetime Sólo artículos creados o modificados desde esa fecha.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 100,
      "SKUCode": "KIT100",
      "Description": "KIT AUDIO COMPLETO",
      "AdditionalDescription": "",
      "AlternativeCode": "",
      "BarCode": "",
      "Commission": 6.0,
      "Discount": 0.0,
      "MeasureUnitCode": "UNI",
      "SecondMeasureUnitCode": "",
      "StockEquivalence": 0.0,
      "StockControlUnit": "P",
      "SalesMeasureUnitCode": "UNI",
      "SalesEquivalence": 1.0,
      "MaximumStock": 0.0,
      "MinimumStock": 0.0,
      "RestockPoint": 0.0,
      "Observations": "",
      "Kit": true,
      "KitValidityDateSince": null,
      "KitValidityDateUntil": null,
      "LastUpdateUtc": "2026-02-14T20:16:30.043",
      "UseScale": "N",
      "Scale1": "",
      "Scale2": "",
      "BaseArticle": "",
      "ScaleValue1": "",
      "ScaleValue2": "",
      "DescriptionScale1": "",
      "DescriptionScale2": "",
      "DescriptionValueScale1": "",
      "DescriptionValueScale2": "",
      "Disabled": false,
      "ProductComposition": [
        {
          "ComponentSKUCode": "0100100150",
          "Quantity": 1
        },
        {
          "ComponentSKUCode": "0100100151",
          "Quantity": 2
        }
      ],
      "ProductComments": [
        {
          "Line": 1,
          "Text": "Comentario para la impresión"
        }
      ]
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Artículos por saldo de stock — GET /ArtPorSaldoStock

Volver a recursos

Devuelve artículos (con la misma forma y las mismas restricciones de perfil y tipo que Product) filtrados por saldo de stock.

Parámetro Tipo Descripción
WarehouseCode string Código de depósito.
StoreNumber string Número de sucursal.
MinStock decimal Saldo de stock mínimo (mayor estricto).
Centraliza bool Incluir stock centralizado.
filter string Filtra por código de artículo (búsqueda parcial).

La respuesta tiene la misma estructura que Product.

Saldos de stock — GET /Stock

Volver a recursos

Parámetro Tipo Descripción
FilterProductCode string Filtra por código de artículo (el operador depende de UseEqual: parcial por defecto).
filter string Filtra por código de artículo (filtro adicional; el operador depende de UseEqual).
StoreNumber string Número de sucursal (valor único; el operador depende de UseEqual). Para consultar varias sucursales a la vez, use StockGroupByProduct.
WarehouseCode string Código de depósito (valor único; el operador depende de UseEqual).
DiscountPendingOrders bool Descuenta las órdenes pendientes.
Id string Filtra por identificador de saldo.
UseEqual bool Búsqueda exacta (true) o parcial (false, valor por defecto). Aplica a FilterProductCode, StoreNumber, WarehouseCode y filter.
Centraliza bool Incluir stock centralizado.
UpdatedDate datetime Sólo saldos actualizados desde esa fecha. El comprometido de DiscountPendingOrders no tiene fecha: sus filas se devuelven también al filtrar, con LastUpdate en null.
groupByProduct bool Si es true, la consulta se resuelve como StockGroupByProduct (saldo agrupado por artículo). Por defecto false.
stockGroupByProduct bool Alias de groupByProduct: si es true, la consulta se resuelve como StockGroupByProduct. Por defecto false.

Ejemplo:

https://{llave}.connect.axoft.com/api/eCommerce/Stock?UpdatedDate=2026-02-14T20:16:30
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "0100200659",
      "MeasureCode": "UNI",
      "SecondMeasureCode": "",
      "WarehouseCode": "1",
      "StoreNumber": 1,
      "Quantity": 120.0,
      "SecondQuantity": 0.0,
      "PendingQuantity": 5.0,
      "SecondPendingQuantity": 0.0,
      "EngagedQuantity": 2.0,
      "SecondEngagedQuantity": 0.0,
      "LastUpdate": "2026-02-14T20:16:30.043"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Saldos de stock agrupados por artículo — GET /StockGroupByProduct

Volver a recursos

Devuelve el saldo agrupado por artículo (sin discriminar sucursal ni depósito: StoreNumber vuelve 0 y WarehouseCode null). El campo LastUpdate del grupo es la mayor fecha de actualización de saldo entre las filas agrupadas que cumplen los demás filtros; null si ninguna tiene fecha.

Parámetro Tipo Descripción
FilterProductCode string Filtra por código de artículo (búsqueda exacta).
filter string Filtra por código de artículo (búsqueda parcial).
WarehouseCode string Código(s) de depósito (lista separada por coma).
StoreNumber string Número(s) de sucursal (lista separada por coma).
DiscountPendingOrders bool Descuenta las órdenes pendientes.
Centraliza bool Incluir stock centralizado.
UpdatedDate datetime Sólo artículos con algún saldo actualizado desde esa fecha. El comprometido de DiscountPendingOrders no tiene fecha: los artículos que lo tienen se devuelven también al filtrar, con el LastUpdate de sus saldos.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "0100200659",
      "MeasureCode": "UNI",
      "SecondMeasureCode": "",
      "StoreNumber": 0,
      "WarehouseCode": null,
      "Quantity": 340.0,
      "SecondQuantity": 0.0,
      "PendingQuantity": 5.0,
      "SecondPendingQuantity": 0.0,
      "EngagedQuantity": 2.0,
      "SecondEngagedQuantity": 0.0,
      "LastUpdate": "2026-02-14T20:16:30.043"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Listas de precios — GET /PriceList

Volver a recursos

Parámetro Tipo Descripción
FilterListNumber string Filtra por número de lista.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 10,
      "PriceListNumber": 2,
      "Description": "LISTA MAYORISTA",
      "CommonCurrency": true,
      "IvaIncluded": true,
      "InternalTaxIncluded": false,
      "ValidityDateSince": null,
      "ValidityDateUntil": null,
      "Disabled": false,
      "Display": "2 - LISTA MAYORISTA"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Precios — GET /Price

Volver a recursos

Parámetro Tipo Descripción
FilterListNumber string Filtra por número de lista.
SkuCode string Filtra por código de artículo (búsqueda parcial).
Id int Filtra por identificador.
DatePrice datetime Sólo precios actualizados desde esa fecha.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 5001,
      "PriceListNumber": 2,
      "SKUCode": "0100200659",
      "Price": 7700.0,
      "DatePrice": "2026-02-14T20:16:30.043",
      "ValidityDateSince": null,
      "ValidityDateUntil": null
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Precios por cliente — GET /PriceByCustomer

Volver a recursos

Parámetro Tipo Descripción
FilterCustomerCode string Filtra por código de cliente.
SkuCode string Filtra por código de artículo (búsqueda parcial).
PriceListNumber string Filtra por número de lista (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "0100200659",
      "CustomerCode": "010010",
      "Price": 7500.0,
      "PriceListNumber": 2
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Descuentos por cliente — GET /DiscountByCustomer

Volver a recursos

Parámetro Tipo Descripción
FilterCustomerCode string Filtra por código de cliente (el operador depende de UseEqual: parcial por defecto).
filter string Filtra por código de cliente (filtro adicional; el operador depende de UseEqual).
UseEqual bool Búsqueda exacta (true) o parcial (false, valor por defecto). Aplica a FilterCustomerCode, SkuCode y filter.
SkuCode string Filtra por código de artículo (el operador depende de UseEqual: parcial por defecto).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "0100200659",
      "CustomerCode": "010010",
      "Discount": 10.0
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Clientes — GET /Customer

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de cliente.
IvaCategoryCode string Filtra por categoría de IVA.
DocumentType string Filtra por tipo de documento.
DocumentNumber string Filtra por número de documento.
UpdatedDate datetime Sólo clientes creados o modificados desde esa fecha.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Code": "010010",
      "BusinessName": "EMPRESA S.A.",
      "TradeName": "EMPRESA",
      "Address": "CERRITO 1186",
      "PostalCode": "1122",
      "City": "CABA",
      "ProvinceCode": "0",
      "TradeAddress": "",
      "PhoneNumbers": "011-3333-3333",
      "Email": "cliente@mail.com",
      "MobilePhoneNumber": "",
      "WebPage": "",
      "IvaCategoryCode": "RI",
      "DocumentType": "80",
      "DocumentNumber": "30111111118",
      "PriceListNumber": 2,
      "Discount": 0.0,
      "Observations": "",
      "DisabledDate": null,
      "UpdateDatetime": "2026-01-10T00:00:00",
      "LastUpdateUtc": "2026-02-14T00:00:00",
      "ShippingAddresses": [
        {
          "Code": "PRINCIPAL",
          "Address": "9 DE JULIO 1186",
          "ProvinceCode": "0",
          "City": "CABA",
          "PostalCode": "1122",
          "PhoneNumber1": "",
          "PhoneNumber2": "",
          "DefaultAddress": "S",
          "Enabled": "S",
          "DeliveryHours": "",
          "DeliversMonday": "S",
          "DeliversTuesday": "S",
          "DeliversWednesday": "S",
          "DeliversThursday": "S",
          "DeliversFriday": "S",
          "DeliversSaturday": "N",
          "DeliversSunday": "N"
        }
      ],
      "CustomerComments": [
        {
          "Line": 1,
          "Text": "Cliente preferencial"
        }
      ],
      "SellerCode": "2",
      "CreditQuota": 500000.0,
      "LocalAccountBalance": 12000.0,
      "ForeignAccountBalance": 0.0,
      "ForeignCurrencyClause": false,
      "CreditQuotaCurrencyCode": "PES",
      "SaleConditionCode": 3,
      "TransportCode": "01"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Vendedores — GET /Seller

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de vendedor.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Code": "2",
      "Name": "JUAN PEREZ",
      "CommissionPercentage": 6.0,
      "Disabled": false
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Transportes — GET /Transport

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de transporte.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "Code": "01",
      "Name": "TRANSPORTE OESTE",
      "IVACategory": "RI",
      "Cuit": "30111111118",
      "SurchargePercentage": 0.0,
      "Address": "AV. SIEMPREVIVA 100",
      "PostalCode": "1122",
      "City": "CABA",
      "ProvinceCode": "0",
      "PhoneNumbers": "011-4444-4444",
      "Email": "",
      "WebPage": "",
      "Comments": ""
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Condiciones de venta — GET /SaleCondition

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de condición.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Code": 1,
      "Description": "CONTADO",
      "Cash": true,
      "GenerateAlternativeDate": false,
      "GenerateDebitLatePayment": false
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Monedas — GET /Currency

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de moneda.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "Id": 1,
      "CurrencyCode": "01",
      "Description": "PESOS",
      "Symbol": "$",
      "Type": "C",
      "RG1547Code": "PES",
      "AFIPCode": ""
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Cotizaciones de moneda extranjera — GET /CurrencyExchangeRate

Volver a recursos

Parámetro Tipo Descripción
FilterIdRenglon string Filtra por identificador de renglón.
LastUpdate datetime Sólo cotizaciones desde esa fecha.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "IdRenglon": 1001,
      "Value": 1050.75,
      "DateTime": "2026-06-30T15:00:00"
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Talonarios — GET /CounterFoil

Volver a recursos

Parámetro Tipo Descripción
FilterCode string Filtra por código de talonario.
Voucher string Filtra por comprobante.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "CounterfoilCode": 1,
      "Description": "FACTURAS A",
      "CounterfoilType": "FAC",
      "Voucher": "FAC",
      "CounterfoilExpiration": null
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Clasificador de artículos — carpetas y contenido

Volver a recursos

GET /ProductsFolder — artículos dentro de las carpetas del clasificador.

Parámetro Tipo Descripción
FilterIdFolder string Filtra por identificador de carpeta (búsqueda exacta).
SkuCode string Filtra por código de artículo (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SkuCode": "0100200659",
      "IdFolder": 12
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

GET /ProductsRelation — relaciones del clasificador de artículos.

Parámetro Tipo Descripción
FilterIdFolder string Filtra por identificador de carpeta (búsqueda exacta).
SkuCode string Filtra por código de artículo (búsqueda parcial).
RelationName string Filtra por nombre de relación (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "SkuCode": "0100200659",
      "IdFolder": 12,
      "RelationName": "RELACIONADOS",
      "ShowRelation": true
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

GET /ProductsFolderClassifier — carpetas del clasificador de artículos.

Parámetro Tipo Descripción
FilterIdFolder string Filtra por identificador de carpeta.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "IdFolder": 12,
      "Name": "ELECTRODOMÉSTICOS",
      "IdParent": null
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Clasificador de clientes — carpetas y contenido

Volver a recursos

GET /CustomersFolder — clientes dentro de las carpetas del clasificador.

Parámetro Tipo Descripción
FilterId string Filtra por identificador de carpeta (búsqueda exacta).
CustomerCode string Filtra por código de cliente (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "CustomerCode": "010010",
      "IdFolder": 5
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

GET /CustomersRelation — relaciones del clasificador de clientes.

Parámetro Tipo Descripción
FilterId string Filtra por identificador de carpeta (búsqueda exacta).
CustomerCode string Filtra por código de cliente (búsqueda parcial).
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "CustomerCode": "010010",
      "IdFolder": 5,
      "RelationName": "MAYORISTAS",
      "ShowRelation": true
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

GET /CustomersFolderClassifier — carpetas del clasificador de clientes.

Parámetro Tipo Descripción
FilterIdFolder string Filtra por identificador de carpeta.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 50,
    "MoreData": false
  },
  "Data": [
    {
      "IdFolder": 5,
      "Name": "CLIENTES MAYORISTAS",
      "IdParent": null
    }
  ],
  "PagingError": null,
  "Message": null,
  "OrderError": null,
  "succeeded": true
}

Funciones de inteligencia artificial

Volver al índice

Las funciones de inteligencia artificial de Tango se consultan con cuatro recursos:

Los tres primeros son recursos independientes, cada uno con sus datos de consulta y sus requisitos. El asistente elige cuál de ellos responde según los datos que recibe: con un texto busca, y con el código de un artículo sugiere complementarios si tiene disponibilidad y sustitutos si no. Se puede llamar al recurso que corresponde en cada caso o delegar la elección en el asistente.

Qué necesita la empresa antes de consultarlos

Todos los recursos necesitan:

  • Artículos del catálogo de eCommerce. Tanto el artículo consultado como los devueltos deben pertenecer al catálogo.
  • La credencial de Tango AI registrada para la empresa.

Además, según el recurso:

  • Sustitutos y búsqueda por descripción: SQL Server 2025 o superior en la base de la empresa y vectores vigentes de los artículos.
  • Complementarios: artículos clasificados en el clasificador de artículos. Funcionan con versiones anteriores de SQL Server. La clasificación, manual o con Clasificación de artículos por AI, no exige que el artículo esté incluido en la búsqueda semántica, por lo que los complementarios pueden devolver artículos que los sustitutos y la búsqueda por descripción nunca devuelven.
  • Asistente: los requisitos del recurso que resuelve en cada consulta. Cuando recibe texto requiere SQL Server 2025, aunque resuelva complementarios.

Los vectores los genera el proceso Stock › Archivos › Actualizaciones › Actualización de datos para búsqueda semántica de artículos, sólo para los artículos incluidos en la búsqueda semántica. Un artículo puede tener vectores generados con su clasificación y sin ella; la configuración de la búsqueda semántica en Stock › Archivos › Carga inicial › Parámetros de AI para Stock decide cuáles de los dos están vigentes. Si al cambiar esa configuración los artículos no tienen vectores generados de la forma elegida, hay que generarlos.

Datos comunes

Volver al índice

Parámetro Tipo Descripción
IncludeUnavailable bool En true incluye los artículos sin disponibilidad. Por defecto toma el valor configurado en Tango, cuyo valor inicial es false.
IncludeStock bool En true anida los saldos por depósito en cada artículo. Por defecto false.
IncludePrices bool En true anida los precios por lista en cada artículo. Por defecto false.
Centraliza bool Incluir stock centralizado. Funciona igual que en el recurso Stock. Determina la disponibilidad y el Stock anidado. En true sobre una empresa que no centraliza no hay saldos: ningún artículo tiene disponibilidad y la respuesta vuelve vacía salvo IncludeUnavailable. Por defecto false.
PageNumber int Sólo admite el valor 1: la respuesta es de página única. Otro valor responde 400.
PageSize int Máximo de resultados, de 1 al tope del recurso. Por defecto 50. Un valor mayor al tope se recorta sin error y la respuesta informa el aplicado. En complementarios se valida pero no limita la respuesta: el tamaño lo definen CategoryCount y ProductsPerCategory, y la respuesta informa el producto de los dos (ver ProductComplementaries).

Qué devuelve cada artículo

SKUCode, Description, MeasureUnitCode y Availability; en los complementarios, además Category. Availability es verdadera cuando la suma de los saldos de stock del artículo en todos los depósitos, y con Centraliza en todas las sucursales, es mayor que cero: los mismos saldos que informa Stock, sin descontar el comprometido ni las órdenes pendientes.

El catálogo de eCommerce

Un artículo pertenece al catálogo de eCommerce cuando tiene marcada la opción Publica en Tango eCommerce, su perfil es Venta o Compra-Venta, es de tipo Simple, Fórmula o Kit fijo y no es un artículo base de escala. El catálogo es un subconjunto de lo que devuelve Product. Pertenecer al catálogo es independiente de tener vectores, estar clasificado o tener disponibilidad: los vectores y la clasificación deciden qué artículos del catálogo puede encontrar cada recurso, y la disponibilidad decide cuáles de los encontrados se devuelven, salvo que IncludeUnavailable los incluya. El artículo consultado también debe pertenecer al catálogo.

Cuando IncludeUnavailable incluye los artículos sin disponibilidad, Availability en false los distingue.

El orden de Data

  • Sustitutos y búsqueda por descripción, directos o a través del asistente: se ordenan de mayor a menor similitud con el artículo consultado o con el texto de búsqueda. A igual similitud, por SKUCode ascendente.
  • Complementarios: se agrupan por categoría, en el orden en que el modelo las sugirió. Dentro de cada categoría, los artículos van en el orden en que se dieron de alta en Tango, del más antiguo al más reciente.
  • Complementarios del asistente con código y texto: se ordenan de mayor a menor similitud con el texto de búsqueda, sin agrupar por categoría. Los artículos sin vector van al final, ordenados entre sí por SKUCode ascendente.

El orden por SKUCode es ordinal: compara los caracteres por su código, por lo que los dígitos van antes que las mayúsculas, y las mayúsculas antes que las minúsculas.

El nivel de precisión (AccuracyLevel)

Define la similitud mínima que deben tener los resultados. Admite los valores maxima, alta, equilibrada, baja y minima, sin distinguir mayúsculas de minúsculas. Por defecto toma el valor configurado en Tango, cuyo valor inicial es equilibrada. A mayor exigencia, los resultados son más similares y su cantidad puede ser menor. La respuesta informa el nivel aplicado en minúscula y sin tilde.

Valores predeterminados configurables

AccuracyLevel, IncludeUnavailable e IncludeSameScaleBase toman su valor predeterminado de la solapa Asistente de ventas (eCommerce) del proceso Stock › Archivos › Carga inicial › Parámetros de AI para Stock. El dato enviado en la consulta siempre prevalece sobre el configurado.

Respuestas vacías

Una consulta válida sin resultados responde 200 con la lista vacía. Message indica la causa:

  • No se encontró el artículo indicado en el catálogo de eCommerce.: el código no existe o el artículo no pertenece al catálogo.
  • El artículo no tiene vectores vigentes. Se generan en el proceso Actualización de datos para búsqueda semántica de artículos.: en sustitutos, directos o a través del asistente.
  • No hay vectores vigentes. Se generan en el proceso Actualización de datos para búsqueda semántica de artículos.: en la búsqueda por descripción y en el asistente sin código.
  • El artículo no está clasificado. Se clasifica en el proceso Clasificador de artículos.: en complementarios, directos o a través del asistente.
  • Las categorías sugeridas no tienen artículos que cumplan los filtros de la consulta.: en complementarios, directos o a través del asistente.
  • No se encontraron artículos para la consulta.: no hay artículos que cumplan los filtros de la consulta.

La respuesta vacía informa las mismas propiedades adicionales que la respuesta con artículos:

Recurso y operación Propiedades adicionales
ProductSubstitutes AccuracyLevel
ProductComplementaries Scope
ProductSemanticSearch AccuracyLevel
ProductAssistant al buscar AccuracyLevel
ProductAssistant al sugerir sustitutos RecommendationType y AccuracyLevel
ProductAssistant al sugerir complementarios RecommendationType y Scope

RecommendationType indica la operación que ejecutó el asistente: Sustitutos o Complementarios. Si la consulta no envía este dato, permite identificar cuál de las dos eligió el asistente.

Respuesta reducida con 200

En las siguientes situaciones, la API responde 200 con succeeded: false y Message, sin Paging ni Data. Lea succeeded antes de deserializarlos.

  • Licencia de la empresa inválida: devuelve el mensaje informado por la validación de licencia.
  • Funciones de AI no disponibles para la empresa: ocurre cuando no están configuradas las credenciales de Tango AI o de Tango Billing. Devuelve el mensaje Las funciones de inteligencia artificial no están disponibles para esta empresa..
  • Tango Billing rechaza la consulta, por ejemplo cuando el saldo es insuficiente: devuelve el mensaje informado por Tango Billing.

Recursos de AI

Volver al índice

Artículos sustitutos — GET /ProductSubstitutes

Volver a recursos de AI

Devuelve artículos similares al consultado, ordenados de mayor a menor similitud. No llama al modelo: compara los vectores ya generados. Requiere SQL Server 2025 o superior en la base de la empresa. El tope de resultados es 500.

Parámetro Tipo Descripción
SkuCode string Obligatorio. Código completo de un artículo del catálogo, hasta 15 caracteres, incluidos los espacios. Requiere que tenga sus vectores generados.
AccuracyLevel string Nivel de precisión que se aplica a la consulta.
IncludeSameScaleBase bool En false excluye las demás combinaciones de la misma base de escala que el artículo consultado (por ejemplo, los otros talles o colores del mismo artículo base). Por defecto toma el valor configurado en Tango, cuyo valor inicial es true.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 10,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "CAF-330",
      "Description": "Cafetera Térmica Boreal",
      "MeasureUnitCode": "UNI",
      "Availability": true
    }
  ],
  "AccuracyLevel": "equilibrada",
  "Message": null,
  "succeeded": true
}

Artículos complementarios — GET /ProductComplementaries

Volver a recursos de AI

Devuelve los artículos complementarios en una lista plana, con la categoría de cada uno como un dato más de la fila. Llama al modelo en cada consulta: le envía la descripción del artículo y el árbol de carpetas del clasificador de artículos de la empresa, y el modelo elige las carpetas cuyos artículos complementan la compra; Category es la descripción de la carpeta. No requiere SQL Server 2025.

Parámetro Tipo Descripción
SkuCode string Obligatorio. Código completo de un artículo del catálogo, hasta 15 caracteres, incluidos los espacios. Requiere que esté clasificado en una carpeta existente.
CategoryCount int Máximo de categorías a sugerir, de 1 a 5. Por defecto 3.
ProductsPerCategory int Máximo de artículos por categoría, de 1 a 50. Por defecto 50.
Scope string Define qué tan cercanas al artículo consultado deben ser las categorías sugeridas por el modelo: directo se limita a categorías de artículos que se usan junto con él, accesorio contempla categorías intermedias y ecosistema incluye categorías más alejadas. Por defecto accesorio.

El tamaño de la respuesta se determina mediante CategoryCount y ProductsPerCategory, no mediante PageSize. Paging.PageSize informa el producto de ambos valores.

Dentro de cada categoría, los artículos se seleccionan por orden de alta en Tango, del más antiguo al más reciente, hasta alcanzar el máximo indicado en ProductsPerCategory. La similitud con el artículo consultado no interviene en la selección.

Si un artículo pertenece a más de una categoría sugerida, se devuelve una sola vez, asociado a la primera. En las categorías siguientes igualmente cuenta dentro del máximo de ProductsPerCategory, por lo que pueden devolver menos artículos que los solicitados.

Las carpetas en las que está clasificado el artículo consultado se descartan, por lo que ese artículo no se devuelve. Otros artículos que compartan alguna de esas carpetas pueden aparecer si también pertenecen a una de las carpetas sugeridas.

Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 150,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "FIL-040",
      "Description": "Filtros de papel N.º 4",
      "MeasureUnitCode": "UNI",
      "Availability": true,
      "Category": "Preparación"
    },
    {
      "SKUCode": "JAR-620",
      "Description": "Jarra térmica 1 L",
      "MeasureUnitCode": "UNI",
      "Availability": true,
      "Category": "Servicio"
    }
  ],
  "Scope": "accesorio",
  "Message": null,
  "succeeded": true
}

Búsqueda por descripción — GET /ProductSemanticSearch

Volver a recursos de AI

Recibe un texto de búsqueda y devuelve los artículos que responden a la consulta. La comparación es por significado: el modelo convierte el texto en un vector y ese vector se compara contra los vectores del catálogo. Llama al modelo una sola vez por consulta. Requiere SQL Server 2025 o superior en la base de la empresa. El tope de resultados es 200.

Parámetro Tipo Descripción
SearchText string Obligatorio. Hasta 1.000 caracteres. Un texto mayor se rechaza con 400, no se recorta.
AccuracyLevel string Nivel de precisión que se aplica a la consulta.
Respuesta
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 10,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "JAR-620",
      "Description": "Jarra térmica 1 L",
      "MeasureUnitCode": "UNI",
      "Availability": true
    },
    {
      "SKUCode": "CAF-330",
      "Description": "Cafetera Térmica Boreal",
      "MeasureUnitCode": "UNI",
      "Availability": true
    }
  ],
  "AccuracyLevel": "equilibrada",
  "Message": null,
  "succeeded": true
}

Asistente de ventas — GET /ProductAssistant

Volver a recursos de AI

El asistente permite delegar en un único recurso la elección de la operación que corresponde según los datos de la consulta: buscar por descripción, sugerir sustitutos o sugerir complementarios. Debe recibir el texto de búsqueda, el código de un artículo o ambos:

  • Sólo el texto: el asistente busca y devuelve lo mismo que la búsqueda por descripción.

  • Sólo el código: el asistente sugiere complementarios si el artículo tiene disponibilidad y sustitutos si no la tiene. RecommendationType decide la operación en lugar de la disponibilidad.

  • Código y texto:

    • Sustitutos: los candidatos se determinan con el mismo criterio que cuando no se envía texto: similitud con el artículo consultado y nivel de precisión. Esos candidatos se ordenan de mayor a menor similitud con el texto.
    • Complementarios: se devuelven los mismos artículos que sin texto. El texto sólo modifica el orden, de mayor a menor similitud con el texto, sin agrupar por categoría.

    Si la empresa no tiene vectores vigentes, el texto se ignora. Si el texto no se puede convertir en vector, la consulta completa falla con succeeded: false.

Un código que no existe o no pertenece al catálogo cuenta como sin disponibilidad, por lo que sin RecommendationType el asistente resuelve sustitutos: en SQL Server anterior a 2025 la consulta responde 409 en lugar de la lista vacía.

Parámetro Tipo Descripción
SkuCode string Código completo de un artículo del catálogo, hasta 15 caracteres, incluidos los espacios. Obligatorio si no se envía SearchText.
SearchText string Texto de búsqueda, hasta 1.000 caracteres. Obligatorio si no se envía SkuCode.
RecommendationType string Complementarios o Sustitutos, un solo valor por consulta. Sin el dato, decide la disponibilidad del artículo. Sin SkuCode, un valor válido se ignora y no se informa en la respuesta; aun así, un valor desconocido o repetido responde 400.
AccuracyLevel string Nivel de precisión que se aplica a la búsqueda por descripción y a los sustitutos.
IncludeSameScaleBase bool Aplica a los sustitutos. En false excluye las demás combinaciones de la misma base de escala que el artículo consultado (por ejemplo, los otros talles o colores del mismo artículo base). Por defecto toma el valor configurado en Tango, cuyo valor inicial es true.
CategoryCount int Aplica a los complementarios. Máximo de categorías a sugerir, de 1 a 5. Por defecto 3.
ProductsPerCategory int Aplica a los complementarios. Máximo de artículos por categoría, de 1 a 50. Por defecto 50.
Scope string Aplica a los complementarios. Define qué tan cercanas al artículo consultado deben ser las categorías sugeridas por el modelo: directo se limita a categorías de artículos que se usan junto con él, accesorio contempla categorías intermedias y ecosistema incluye categorías más alejadas. Por defecto accesorio.

El tope es el del recurso equivalente: 200 al buscar, 500 en sustitutos, y 5 categorías de hasta 50 artículos en complementarios. Una consulta sin código y sin texto responde 400. El asistente valida todos sus datos aunque la operación ejecutada no los use: por ejemplo, CategoryCount fuera de rango responde 400 también cuando la consulta sólo trae texto.

Respuesta al sugerir complementarios
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 150,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "FIL-040",
      "Description": "Filtros de papel N.º 4",
      "MeasureUnitCode": "UNI",
      "Availability": true,
      "Category": "Preparación"
    }
  ],
  "RecommendationType": "Complementarios",
  "Scope": "accesorio",
  "Message": null,
  "succeeded": true
}
Respuesta al sugerir sustitutos
{
  "Paging": {
    "PageNumber": 1,
    "PageSize": 10,
    "MoreData": false
  },
  "Data": [
    {
      "SKUCode": "CAF-330",
      "Description": "Cafetera Térmica Boreal",
      "MeasureUnitCode": "UNI",
      "Availability": true
    }
  ],
  "RecommendationType": "Sustitutos",
  "AccuracyLevel": "equilibrada",
  "Message": null,
  "succeeded": true
}

Saldos y precios anidados

Con IncludeStock e IncludePrices cada artículo lleva sus saldos y sus precios, con la misma forma que en Stock y Price, recortados a los datos que estos recursos informan. Stock equivale a consultar Stock con DiscountPendingOrders en false. Las colecciones viajan completas: Paging describe sólo a Data.

{
  "SKUCode": "CAF-330",
  "Description": "Cafetera Térmica Boreal",
  "MeasureUnitCode": "UNI",
  "Availability": true,
  "Stock": [
    {
      "WarehouseCode": "1",
      "StoreNumber": 1,
      "Quantity": 4.0,
      "PendingQuantity": 0.0,
      "EngagedQuantity": 1.0
    }
  ],
  "Prices": [
    {
      "PriceListNumber": 1,
      "Price": 102500.0,
      "DatePrice": "2026-08-01T09:00:00",
      "ValidityDateSince": null,
      "ValidityDateUntil": null
    }
  ]
}

Con IncludeStock o IncludePrices, un artículo sin saldos o sin precios lleva la colección correspondiente vacía.

Aspectos particulares de los recursos de AI

Volver al índice

Estos cuatro recursos se diferencian de los demás recursos de la API en los siguientes puntos:

  • SkuCode identifica exactamente un artículo del catálogo: debe coincidir con el código completo, de hasta 15 caracteres, incluidos los espacios. En los demás recursos actúa como filtro parcial. Sin coincidencia, o con un artículo fuera del catálogo, la respuesta es 200 con la lista vacía y el mensaje que lo indica.
  • Un dato que no se puede interpretar según su tipo responde 400 con El valor de {dato} no es válido., por ejemplo PageSize=abc o IncludeStock=1.
  • Los valores de dominio no distinguen mayúsculas de minúsculas (AccuracyLevel, Scope, RecommendationType) y la respuesta los informa en su forma canónica.
  • SkuCode se compara tal como llega, con sus espacios iniciales, intermedios y finales. De SearchText, AccuracyLevel, Scope y RecommendationType se quitan los espacios iniciales y finales. Un dato vacío o sólo de espacios equivale a omitirlo. El parámetro filter de los demás GET no aplica a estos recursos y se ignora.
  • Cada dato se envía una sola vez. RecommendationType repetido responde 400, aunque uno de los valores venga vacío; los demás datos conservan el primer valor recibido.
  • La respuesta es de página única: MoreData siempre en false y PageNumber sólo admite 1.
  • El 400 responde con succeeded y Message, no con la propiedad errors de los demás recursos, y nombra una sola causa.
  • Propiedades ausentes: no llevan TotalCount, PagingError ni OrderError.
  • Sólo se devuelven artículos que tengan marcada la opción Publica en Tango eCommerce en el proceso Stock › Archivos › Actualizaciones › Artículos. Las demás condiciones se detallan en el catálogo de eCommerce.
  • Cada consulta tiene una espera máxima para las llamadas al modelo. Al vencer, la respuesta es 504 con succeeded: false y el mensaje que pide reintentar.
  • Las respuestas llevan Cache-Control: no-store, salvo el 401 por credenciales ausentes o inválidas, que se emite antes de ejecutar el recurso (ver Códigos de estado HTTP).

Migración desde la API de Tango Tiendas

Volver al índice

Si hoy integra con la API de Tango Tiendas (api/Aperture) y migra a la API de eCommerce, tenga en cuenta los siguientes cambios de contrato.

Plataforma y autenticación

Tema Tango Tiendas eCommerce
Prefijo de ruta api/Aperture/* Api/eCommerce/*
Host https://tiendas.axoft.com https://{llave}.connect.axoft.com
Autenticación header AccessToken headers ApiAuthorization + Company
Selección de tienda en POST embebida en el token parámetro ?Cuenta=
Prueba de autenticación POST Dummy → Valid AccessToken POST Dummy → Valid ApiAuthorization

Formato de respuesta y estados

  • Una cuenta de integración inexistente en los POST responde "<cuenta> is not registered." (en Tiendas: "Invalid AccessToken").
  • Códigos de estado: el resultado de la operación se consulta en el campo succeeded (ver Códigos de estado HTTP). Cambios puntuales respecto de Tiendas:
    • Un GET sin resultados devuelve 200 con Data: [] (en Tiendas: 400); detecte el fin de la paginación con Paging.MoreData: false o Data vacío.
    • Un token inválido devuelve 401.
    • Una ruta inexistente bajo el prefijo Api/eCommerce devuelve 404 con un cuerpo JSON que indica el error en Message, en cualquier verbo.
    • Los datos inválidos en el POST Order responden 400 con el detalle por campo en la propiedad errors (en Tiendas: 200 con isOk: false).

Recursos nuevos

  • GET ArtPorSaldoStock y GET StockGroupByProduct son rutas nuevas de eCommerce; la capacidad ya existía en Tiendas (respectivamente, POST DataBy/ArtPorSaldoStock y Stock con GroupByProduct=true).
  • POST Dummy no es un recurso nuevo: ya existía en Tiendas y sólo cambia el mensaje de la prueba de autenticación (ver la tabla de plataforma más arriba).

Parámetros

  • Los recursos GET agregan filtros nombrados propios (FilterCode, FilterListNumber, FilterProductCode, etc.), de búsqueda exacta — salvo en Stock y DiscountByCustomer, donde el operador depende de UseEqual (parcial por defecto).
  • Los parámetros sort y validatePageSize de Tiendas no están disponibles en eCommerce; lastUpdate se conserva sólo en CurrencyExchangeRate (ver el recurso).

Consideraciones

Volver al índice

About

Ingreso de órdenes y consulta de datos para integraciones de Tango eCommerce

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors