Agora no Bluesoft ERP, é possível consultar informações completas e detalhadas que abrangem custos, fretes adicionais, descontos desonerados, acordos comerciais, dados fiscais e as novas diretrizes da Reforma Tributária via API.

Como Irá Funcionar a Partir de Agora?

A atualização do endpoint foi realizada de forma somente aditiva. Isso significa que nenhum campo atual foi removido, renomeado ou teve seu formato alterado, garantindo total compatibilidade com as integrações que já estão em execução.

Principais Mudanças no Retorno da API:

  • Padronização Visual: Todos os novos campos foram implementados seguindo o padrão de nomenclatura em camelCase.
  • Composição de Custos: Inclusão dos campos de custo unitário anterior (custoUnitarioAnterior) e custo final original do item (custoFinalOriginal).
  • Fretes e Despesas Adicionais: Retorno de tipo de frete adicional (tipoFreteAdicional), valor de frete adicional (freteAdicionalValor) e despesa tributada de IPI (despesaTributadaIpi).
  • Acordos Comerciais: Exposição de verbas, acordos de sell-in e valores acordados de bonificação.
  • Reforma Tributária: Retorno completo dos novos campos fiscais para suporte ao IBS (UF e Município) e CBS, incluindo suas respectivas chaves, valores brutos/líquidos, fórmulas fiscais, bases de cálculo, diferimentos e devoluções.

Regras de Funcionamento e Filtros

O comportamento da consulta foi preservado para assegurar a consistência operacional:

  1. Filtros Mantidos: O integrador poderá continuar filtrando por fornecedorKey, divisaoKey, produtoKey, contratoFornecimentoKey, dataVigorarInicial, dataVigorarFinal, vigente e negociacaoKey.
  2. Parâmetro Padrão: Quando o parâmetro padrao não for explicitamente enviado na requisição, o ERP adotará automaticamente o valor false.
  3. Paginação: O retorno da consulta permanece paginado.

Observações Importantes!

  • Validação de Período: O ERP rejeitará requisições nas quais a dataVigorarInicial informada for maior que a dataVigorarFinal, retornando um erro de validação impeditivo.

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r369.20