Agora no Bluesoft ERP, é possível o preenchimento da placa do veículo no ato da criação de uma carga de recebimento via API

O Que Mudou?

O endpoint de inclusão de carga foi atualizado para aceitar o atributo placaVeiculo. Além disso, a API passou a respeitar o parâmetro de sistema do módulo de Estoques e NF-e, tornando o campo obrigatório ou opcional de acordo com a configuração da loja.

Benefícios:

  • Integridade de Dados: Garante que a placa informada manualmente prevaleça sobre informações divergentes vindas de CT-e.
  • Padronização: Validação automática dos formatos de placa Nacional e Mercosul.
  • Auditabilidade: Registro automático de todas as inclusões ou alterações de placa no log de ocorrências da carga.

Como Irá Funcionar a Partir de Agora?

A integração via API foi ajustada para espelhar o comportamento das telas de Manutenção do Recebimento de Cargas (Desktop) e Recebimento de Cargas (Mobile).

  1. Parâmetro de Controle: O sistema valida o status do parâmetro: 'Permite informar/alterar Placa no Recebimento de Cargas'.
    • Se Ativo: O envio do campo placaVeiculo torna-se obrigatório na requisição POST.
    • Se Inativo: O preenchimento do campo na API torna-se opcional.
  2. Endpoint de Inclusão (POST):
    • Recurso: /api/compras/recebimentocargas/criar-carga.
    • Novo Atributo: placaVeiculo (Texto Alfanumérico).
    • Exemplo de Payload: {"nfKeys": [113197, 113198], "placaVeiculo": "ABC1D23"}.
  3. Validações e Regras:
    • Formato: O sistema aceita os padrões antigo (ABC-1234) e Mercosul (ABC1D23), validando a máscara e o comprimento (7 a 8 caracteres).
    • Tratamento de Erros: Caso o parâmetro esteja ativo e a placa não seja enviada, a API retornará erro HTTP 400 com a mensagem: “Campo placaVeiculo é obrigatório para prosseguir com a criação de carga de recebimento”.
    • Persistência: A placa enviada via API será gravada diretamente na carga e estará disponível para consulta imediata no ERP.

Observações / Validações

  • Log de Ocorrências: Todas as ações via API registram automaticamente a placa informada, o usuário (via token) e a data/hora no formato DD/MM/AAAA HH:MM.

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