ProtheusClienteFull (STATUS: PARCIAL)

Documentação Técnica

Nome do cliente	OSKLEN
Nome do projeto	Integração LINX → Protheus
Biblioteca	wosk_protheus_cliente_full
Token da Biblioteca	d1444b58-fc25-4211-845d-a12be3cc09b7
URL de Produção	https://isnapp.illimitar.pro/bibliotecas/d1444b58-fc25-4211-845d-a12be3cc09b7/wosk_protheus_cliente_full
URL de Homologação	https://hmg-isnapp.illimitar.pro/bibliotecas/d1444b58-fc25-4211-845d-a12be3cc09b7/wosk_protheus_cliente_full
Data	25/02/2026

Sumário

 

• Documentação Técnica
  
• Sumário

• Histórico de Versões

• Descrição Geral dos Processos
  • Capturador Manual
  • Queue
• Fluxo do Processo
• Critérios de Aceitação

Histórico de Versões

Data	Versão	Modificado por	Descrição da Mudança
25/02/2026	1.0	Maykon/Gustavo	Criação da documentação técnica do processo ProtheusClienteFull.

 

Descrição

Esta biblioteca organiza a integração de cadastros de clientes do LINX para o Protheus, garantindo que cada cliente seja identificado, preparado e encaminhado para envio.

 

Capturador Manual

Descrição Conceitual

Permite a captura manual de um ou mais clientes específicos (informando as chaves).

Quandomediante a captura é manual, valida informação das chaves, com validação obrigatória do formato da chave no padrão A1_LOJA-A1_COD. SeCaso oa chave informada esteja fora do padrão estiver incorreto,o, o processo interrompeé imediatamente interrompido com erro de chave inválida.

lida,

Montagarantindo a consulta a partir de uma view de origemintegridade e complementa a condição dinamicamente com os valores de A1_LOJA e A1_COD.

Para cada registro retornado, gera a chave de filaprevisibilidade no padrão A1_LOJA-A1_COD e registra o item para processamento em fila.fluxo.

Entrada de dados (consulta completa)

A origem dos dados é a view WOSK_SERVICO_ENVIA_PROTHEUS_CLIENTES_FULL, consultada com a projeção abaixo.predefinida, Osendo o filtro por loja (A1_LOJA) e código do cliente é(A1_COD) acrescentado dinamicamente durante a execução. Para cada registro retornado, é gerada a chave de fila no mesmo padrão fluxo.e o item é devidamente registrado para processamento em fila.

 

Fonte

SELECT
    A1_COD,
    A1_LOJA,
    CGC_CPF,
    NOME,
    PESSOA,
    NOME_REDUZ,
    ENDERECO,
    BAIRRO,
    COMPLEMENTO,
    TIPO,
    UF,
    COD_MUNICIPIO_IBGE,
    CEP,
    DDI,
    DDD,
    TELEFONE,
    CONTATO,
    A1_PFISICA,
    A1_INSCR,
    INSC_MUNICIPAL,
    DATA_NASC,
    EMAIL,
    COD_PAIS_SISCOMEX,
    COD_PAIS_BC,
    A1_CONTA,
    A1_CONTRIB,
    A1_TPESSOA,
    A1_SUFRAMA,
    A1_CALCSUF,
    A1_CODMUN,
    STATUS,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_CLIENTES_FULL
WHERE
    A1_LOJA = '<A1_LOJA>'
    AND A1_COD = '<A1_COD>'

 

Operações com dadosDados

(Banco

Leitura: de Dados)

Resultado do processamento

Ao final, os clientes elegíveis ficam registrados na fila para integração, e o controle de continuidade permite que o processo retome sem perder a referência de posição quando aplicável.

Queue

 

Fila de Processamento

Descrição Conceitual

Reestruturação

 e

alteraç

Estruturação de dados

Dados

O conteúdo do item é convertido do padrão de origem (campos mais descritivos)ajustado para o padrão esperado pelo Protheus (campos A1_*).

A seguir está o mapeamento

Mapeamento de campos aplicado:

 

Tratamento de Dados

Após o mapeamento, são aplicadas asos seguintes alteraçõestratamentos no payload:

Chamada

 de

integraç

Integração com o Protheus

Exemplo de payload enviado: (valores ilustrativos):

{
    "A1_COD": "157612267",
    "A1_LOJA": "03",
    "A1_CGC": "15763336703",
    "A1_NOME": "TESTE",
    "A1_PESSOA": "F",
    "A1_NREDUZ": "TESTE",
    "A1_END": "RUA SILVIA POZZANO, 2820",
    "A1_BAIRRO": "RECREIO DOS BANDEIRANTES",
    "A1_COMPLEM": "B1 AP 811,",
    "A1_TIPO": "F",
    "A1_EST": "RJ",
    "A1_COD_MUN": "02257",
    "A1_CEP": "22790622",
    "A1_DDI": "",
    "A1_DDD": "99",
    "A1_TEL": "993207988",
    "A1_CONTATO": "TESTE",
    "A1_PFISICA": "",
    "A1_INSCR": "ISENTO",
    "A1_INSCRM": "",
    "A1_DTNASC": "06/05/9999",
    "A1_EMAIL": "TESTE",
    "A1_PAIS": "105",
    "A1_CODPAIS": "01099",
    "A1_CONTA": "220301040199",
    "A1_CONTRIB": "2",
    "A1_TPESSOA": "",
    "A1_SUFRAMA": "",
    "A1_CALCSUF": "",
    "A1_CODMUN": "",
    "A1_MSBLQL": "2"
}

 

Tratamento de retorno

Encaminhamento em cenário de erro