ProtheusTransportadora (STATUS: AJUSTADO)

Documentação Técnica

Histórico de Versões

Descrição

Este serviço integra os cadastros de transportadoras do LINX para o Protheus, garantindo captura consistente e envio com validação de retorno.

Capturador

Descrição Conceitual

Permite a captura manual (por códigos) e a captura automática (por agendador de tarefas) dos registros pendentes de integração, consultando a origem e registrando os registros para processamento assíncrono.

A captura automática segue processamento cronológico (ordenação/paginação por data), a partir do campo DATA_PARA_TRANSFERENCIA, para priorizar registros mais antigos e manter continuidade por posição; link conceitual: Processamento cronológico.

Fonte

Origem consultada: view WOSK_SERVICO_ENVIA_PROTHEUS_TRANSPORTADORAS.
Consulta utilizada na captura automática (WHERE e paginação construídos dinamicamente conforme posição e configuração de limite):

SELECT
    CODIGO,
    NOME,
    NOME_REDUZ,
    ENDERECO,
    BAIRRO,
    COMPLEMENTO,
    UF,
    COD_MUNICIPIO_IBGE,
    CEP,
    DDI,
    DDD,
    TELEFONE,
    CGC,
    INSCRICAO,
    EMAIL,
    COD_PAIS_BC,
    A4_MSBLQL,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_TRANSPORTADORAS
WHERE
    DATA_PARA_TRANSFERENCIA >= '<DATA_PARA_TRANSFERENCIA>'
ORDER BY
    DATA_PARA_TRANSFERENCIA ASC
OFFSET
    <OFFSET> ROWS FETCH NEXT <LIMITE> ROWS ONLY

Consulta utilizada na captura manual (lista de códigos e WHERE construído dinamicamente):

SELECT
    CODIGO,
    NOME,
    NOME_REDUZ,
    ENDERECO,
    BAIRRO,
    COMPLEMENTO,
    UF,
    COD_MUNICIPIO_IBGE,
    CEP,
    DDI,
    DDD,
    TELEFONE,
    CGC,
    INSCRICAO,
    EMAIL,
    COD_PAIS_BC,
    A4_MSBLQL,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_TRANSPORTADORAS
WHERE
    CODIGO IN ('<CODIGO_1>','<CODIGO_2>')

Operações com Dados

- Leitura: consulta a view WOSK_SERVICO_ENVIA_PROTHEUS_TRANSPORTADORAS para obter o registro atual de transportadora (campo-chave CODIGO) e encaminhar para processamento assíncrono.
- Leitura auxiliar de chaves com falha (checagem): consulta a tabela wosk_capturar filtrando por ProtheusTransportadora e situação igual erro, retornando até 500 chaves para suporte operacional.

Fila de Processamento

Descrição Conceitual

A fila recupera um registro pendente e utiliza o conteúdo do registro como base do payload de integração. Em seguida, aplica transformações obrigatórias de padronização e realiza a chamada ao Protheus.

Estruturação de Dados

{
  "A4_COD": "",
  "A4_NOME": "",
  "A4_NREDUZ": "",
  "A4_END": "",
  "A4_BAIRRO": "",
  "A4_COMPLEM": "",
  "A4_EST": "",
  "A4_COD_MUN": "",
  "A4_CEP": "",
  "A4_DDI": "",
  "A4_DDD": "",
  "A4_TEL": "",
  "A4_CGC": "",
  "A4_INSEST": "",
  "A4_EMAIL": "",
  "A4_CODPAIS": "",
  "A4_MSBLQL": ""
}

Tratamento de Dados

Quando algum campo não estiver disponível no registro atual, o valor é preenchido de forma consistente (ex.: vazio), garantindo que o envio mantenha o formato esperado pelo Protheus.

Integração com o Protheus

Chamada de integração com o Protheus
- Chamada: Requisição HTTP
- Recurso: /rest/transportadora
- Método POST
- Cabeçalhos: nenhum cabeçalho explícito informado na chamada

Tratamento de retorno

  - Ausência de resposta: registra erro com mensagem de JSON: NÃO HOUVE RESPOSTA. e finaliza o registro como falha.
  - Resposta inválida/inesperada: se o retorno não puder ser interpretado como estrutura contendo Mensagem, registra erro de decodificação e finaliza como falha.
  - Indicadores de erro: finaliza como falha quando houver code no retorno ou quando Mensagem for ERRO. Quando disponível, utiliza Mensagem Detalhada como mensagem final.
  - Sucesso: quando não houver indicadores de erro, finaliza como sucesso e persiste o retorno para auditoria.Ao final do processamento, o registro é atualizado na fila de processamento com o retorno do Protheus (quando existir), a mensagem consolidada e a situação final (sucesso/erro). O tempo de processamento é registrado para acompanhamento operacional.

Ao final do processamento, o registro é atualizado na fila de processamento com o retorno do Protheus (quando existir), a mensagem consolidada e a situação final (sucesso/erro). O tempo de processamento é registrado para acompanhamento operacional.

Encaminhamento em cenário de erro

Quando ocorre erro na integração (ausência de resposta, resposta inválida ou retorno com indicador de falha), o registro é finalizado como erro e permanece registrado fila de processamento com detalhes de mensagem e retorno, permitindo acompanhamento e reprocessamento conforme necessidade operacional.

Notificação

Fluxo do Processo

Critérios de Aceitação