Integración con Avalara

Cuando emite el pedido, Demander consulta a Avalara y completa el IPI, el ICMS y el ICMS ST de cada ítem.

Avalara no es un producto de Demander. La cuenta y las credenciales quedan en Avalara.

El módulo de tributación sigue valiendo para el cálculo hecho por Demander. Con Avalara configurada, los impuestos del pedido vienen de la consulta en línea.

Qué vuelve en el ítem

Cada ítem del pedido recibe:

• valor unitario con impuestos
• valor y alícuota de IPI
• valor y alícuota de ICMS ST
• valor y alícuota de ICMS

El valor unitario con impuestos es el valor total del ítem, ya con los impuestos, dividido por la cantidad.

Qué configurar

1. En Configuraciones de la empresa, pestaña Módulos adicionales, marque Habilitar módulo de cálculo de impostos (IPI e ICMS ST).
2. En Configuraciones de la empresa, pestaña Configuraciones adicionales, grupo Pedido, marque Habilitar calculo de Impostos Online. El socio y el equipo Demander ven esta opción. El usuario de la empresa no la ve.
3. La emisión del pedido tiene que estar en línea. El cálculo llama a la API en ese momento. Sin conexión, el pedido no recibe los impuestos de Avalara.
4. Registre una configuración Avalara para la empresa, como en la sección siguiente. Solo se permite una configuración por empresa.

En el registro del vendedor, pestaña Configuración, el campo Calcular impostos online define la excepción:

• Conforme configuração da empresa: sigue el punto 2.
• Sim: calcula en línea aunque la empresa no haya marcado Habilitar calculo de Impostos Online.
• Não: no calcula en línea, aunque la empresa haya marcado esa opción.

Dónde configurar

En Demander Web, abra Configurações Avalara.

Campo en la pantalla	Qué completar
Client Id	Identificador de la cuenta Avalara.
Client secret	Secreto de la cuenta Avalara.
Configuração json auxiliar	JSON de la empresa, descrito abajo. Obligatorio.
Tempo máximo para time out em segundos	Tiempo máximo de la consulta. El estándar es 10. Si Avalara no responde en ese tiempo, el cálculo falla.

JSON de la empresa

El campo Configuração json auxiliar guarda cuentas contables, sector de actividad y el tipo de operación de Avalara para cada tipo de pedido.

{
  "assetAccount": "",
  "expenseAccount": "",
  "incomeAccount": "",
  "activitySector": {
    "type": "",
    "code": ""
  },
  "operationType": {
    "padrao": "",
    "dePara": [
      {
        "codTipoPedido": 1,
        "valor": ""
      }
    ]
  }
}

Los valores vienen del registro de la empresa en Avalara. Demander no trae una lista preparada.

Tag	Uso
assetAccount	Cuenta de activo. Obligatoria.
expenseAccount	Cuenta de gasto. Obligatoria.
incomeAccount	Cuenta de ingreso. Obligatoria.
activitySector.type y activitySector.code	Sector de actividad del establecimiento. Los dos son obligatorios.
operationType.dePara	Une el código del tipo de pedido en Demander (codTipoPedido) al tipo de operación de Avalara (valor).
operationType.padrao	Tipo de operación usado cuando el tipo de pedido del pedido no está en dePara.

Si el tipo de pedido no está en dePara y padrao está vacío, el cálculo se detiene con el mensaje de tipo de operación no configurado para ese tipo de pedido.

JSON del producto

Cada producto del pedido necesita estos datos en el registro. Entran por la integración, en el layout de la Tabla 15 – Productos, campo 42 (jsonCamposAuxiliares). El JSON tiene que traer useType e itemDescriptor. Sin uno de ellos, Demander no calcula el impuesto de ese producto.

{
  "useType": "",
  "itemDescriptor": {
    "issBehavior": "",
    "hsCode": "",
    "ex": "",
    "cest": "",
    "source": "",
    "productType": "",
    "isIcmsStSubstitute": false
  }
}

Tag	Uso
useType	Tipo de uso del ítem en Avalara.
issBehavior	Comportamiento del ISS.
hsCode	NCM.
ex	Excepción de la TIPI.
cest	CEST.
source	Origen de la mercadería.
productType	Tipo del producto en Avalara.
isIcmsStSubstitute	Indica si el establecimiento es sustituto de ICMS ST.

La tag tiene que existir. El valor aceptado es el que Avalara espera para ese producto.

En el pedido

Con esta configuración, el pedido muestra el botón Aplicar impostos. Mientras consulta, la pantalla queda en Calculando impostos…

Al guardar, Demander consulta de nuevo. Si el valor unitario con impuestos de algún ítem cambia, aparece el aviso Pedido atualizado: los impuestos se aplicaron y el total del pedido cambió, de un valor a otro. Solo sigue quien confirme.

El pedido necesita al menos un ítem con cantidad mayor que cero. El cliente del pedido tiene que existir en Demander, con nombre, dirección, CPF o CNPJ, inscripción estadual y ciudad.

El CNPJ enviado como establecimiento es el de la filial del pedido. Si la filial no tiene CNPJ, va el CNPJ de la empresa.

Persona física sigue como individual. Persona jurídica sigue como business. Cliente con tipo de cliente tributario completado sigue como contribuyente de ICMS.

Si la empresa también usa Sankhya o Focco

El cálculo en línea usa una integración por vez, en este orden:

1. Sankhya, cuando la integración Sankhya de la empresa está activa.
2. Avalara, cuando existe la configuración Avalara y Sankhya no está activa.
3. Focco, cuando la integración Focco está activa y las dos anteriores no se aplican.

Con Sankhya activa, la configuración Avalara no entra en el pedido.

Mensajes comunes

Mensaje	Qué revisar
Configuração auxiliar não configurada para a empresa.	JSON auxiliar de la configuración Avalara vacío o inválido.
assetAccount, expenseAccount, incomeAccount o activitySector não configurada para a empresa.	Tag ausente o vacía en el JSON de la empresa.
Tipo de operação Avalara não configurado para o tipo de pedido.	Incluya el codTipoPedido en el dePara o complete padrao.
Cliente não localizado para cálculo de impostos.	Cliente del pedido no encontrado en la empresa.
Produto não localizado para cálculo de impostos.	El código del producto del ítem no existe en la empresa.
Produto com json auxiliar inválido, ou sem useType / itemDescriptor.	Complete el JSON auxiliar del producto citado en el mensaje.
Um ou mais campos obrigatórios não foram informados.	Avalara rechazó el envío por campo faltante.
Não foi possível identificar o CFOP.	La combinación enviada no generó CFOP en Avalara.
Não foi possível obter o access_token.	Revise Client Id y Client secret.