Agora no Bluesoft ERP, é possível informar um texto personalizado no campo de observações da Nota Fiscal no momento do faturamento de uma transferência multiloja realizado via API.

Objetivo

O objetivo desta melhoria é conferir maior autonomia e flexibilidade aos processos de integração, permitindo que o cliente envie dados adicionais específicos para a emissão do documento fiscal através do fluxo automatizado, eliminando a necessidade de intervenções manuais no ERP para este fim.

Como Irá Funcionar a Partir de Agora?

O contrato do método POST no endpoint de faturamento foi expandido para incluir o novo atributo opcional observacoesNf.

Detalhes técnicos do novo campo:

  • Método: POST
  • Path: /api/estoques/operacoes-entre-lojas/transferencia-com-faturamento
  • Atributo: observacoesNf
  • Tipo: String
  • Tamanho Máximo: 500 caracteres.
  • Obrigatoriedade: Opcional.

Exemplo de JSON: 

{
  "preTransfMultilojasKey": 2,
  "lojaOrigemKey": 1,
  "lojaDestinoKey": 16,
  "emailFaturamento": "exemplo@email.com",
  "observacoesNf": "TEXTO DA OBSERVAÇÃO PARA A NF-E",
  "produtos": [
    {
      "produtoKey": 376579,
      "gtin": 7500435027288,
      "quantidadeConferida": 10
    }
  ]
}

Observações / Validações

  • Sanitização Automática:
    O sistema realiza o tratamento automático de caracteres especiais impeditivos (ex: &, <, >, ") para garantir a integridade do XML da NF-e e evitar rejeições da SEFAZ por malformação.
  • Concatenação Inteligente:
    O texto enviado via API será concatenado às observações automáticas já existentes no ERP, garantindo que nenhuma informação sistêmica relevante seja sobrescrita.
  • Transmissão para SEFAZ:
    A observação final (automática + API) é transmitida integralmente para o grupo de informações complementares da Nota Fiscal.
  • Permissões:
    A operação via API exige que o usuário autenticado possua a permissão 4249 - API Transferência Multiloja (Incluir).
  • Processamento assíncrono:
    Será gerado um requestId que deve ser consultado o processamento no endpoint /api/monitoramento/async/{requestId}

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 r367.01