LojaAjusteEstoque (STATUS: CRIADO)

COR_PRODUTO{
  "codigo": "...",
  "nome": "...",
  "endereco": {
    "cep": "00000000",
    "referencia": "",
    "logradouro": "...",
    "numero": "...",
    "complemento": "...",
    "bairro": "...",
    "cidade": "...",
    "uf": "...",
    "pais": "...",
    "codigo_ibge": "...",
    "codigo_bacen": "..."
  },
  "tipo_cliente": ["CLIENTE"],
  "filialCadastro": "...",
  "contatos": [
    { "tipo": "TELEFONE", "contato": "11999999999" }
  ],
  "situacao": "1",
  "tipo": "FISICA",
  "cpf": "00000000000"
}

Tratamento de Dados

Sobre o registro atual retornado de ESTOQUE_PROD_CONTAGEM anteslido do envioconteudo àna fila:

• ITENSDDD, TELEFONE, DDD_CELULAR, CELULAR: passanormalizados acom conter remoção array de linhasnão obtidasdígitos dae consultamontagem ade entradas em ESTOQUE_PROD_CTG_AJUSTEcontatos paracom o mesmotipos NOME_CONTAGEM, preservando os campos NOME_CONTAGEMTELEFONE, PRODUTO, COR_PRODUTO, QTDE_AJUSTE, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A13, A14, A15, A16, A17, A18, A19, A20, A21, A22, A23, A24, A25, A26, A27, A28, A29, A30, A31, A32, A33, A34, A35, A36, A37, A38, A39, A40, A41, A42, A43, A44, A45, A46, A47, A48, CUSTO1, CUSTO2, CUSTO3, CUSTO4, CM_OPERACAOCELULAR e DATA_PARA_TRANSFERENCIAEMAIL quando informados.
• TIPO_LOGRADOURO, ENDERECO: concatenados para formar o logradouro completo; se o resultado exceder 250 caracteres, aplicado substr até 250.
• COMPLEMENTO: se o comprimento exceder 250 caracteres, aplicado substr até 250.
• CEP: somente dígitos e preenchimento à esquerda com zeros até tamanho 8.
• NUMERO: somente dígitos no payload de endereço.
• UF: se vazio ou com mais de 2 caracteres, usa regra condicionada a ESTRANGEIRO (incluindo uso de EX para estrangeiro).
• CPF_CGC, RG_IE: documentos numéricos padronizados com zeros à esquerda conforme tipo físico ou jurídico; tipo derivado pelo tamanho numérico de CPF_CGC após normalização.
• Validação pré-envio: para não estrangeiro com UF diferente de EX, exige IBGE preenchido; para qualquer registro, exige PAIS_BC preenchido (mensagens de erro específicas se ausentes).

Na fila, o processamento utiliza o conteúdo do registro como corpo enviado ao ILLI, sem reestruturação adicional de campos no código analisado além do conteúdo já montado na captura.

Integração com o ILLI

Chamada de integração com o ILLI:ILLI (via rotina de integração):

• Chamada: Requisição HTTP (encapsulada pela rotina de envio ao ILLI).
• Recurso: e3a6737d-ac74-4ed6-9668-e3921320c29f/ilx_ajuste_estoque/setAjuste/bibliotecas/48df1d4a-2a73-4afc-be75-a8104533cda0/ilx_pessoa/setCliente
• Método HTTP: POST
• CorpoCabeçalhos: os definidos internamente pela rotina de entrada:integração ILLI (não fixados neste arquivo).
• Corpo: objeto ouJSON arraycom correspondenteos aocampos mapeados a partir do conteudo do registro da filafila, (cabeçalho da contagem +incluindo ITENSendereco).
,
• Processamento:contatos, envio do payloaddocumentos e leiturametadados dade resposta JSON com indicadores success e message.cadastro.

Exemplo

{
  "id": false,
  "codigo": "00000000000123",
  "nome": "Cliente Exemplo",
  "endereco": {
    "cep": "01310100",
    "referencia": "",
    "logradouro": "RUA EXEMPLO 100",
    "numero": "100",
    "complemento": "SALA 1",
    "bairro": "CENTRO",
    "cidade": "SAO PAULO",
    "uf": "SP",
    "pais": "BRASIL",
    "codigo_ibge": "3550308",
    "codigo_bacen": "1058"
  },
  "tipo_cliente": ["CLIENTE"],
  "filialCadastro": "FILIAL01",
  "genero": "M",
  "grupo": "CLIENTE VAREJO",
  "complemento": "OBS",
  "contatos": [
    { "tipo": "TELEFONE", "contato": "11999999999" }
  ],
  "situacao": "1",
  "data_nascimento": "1990-01-01 00:00:00",
  "data_cadastro": "2024-01-01 10:00:00",
  "data": "2024-01-02 08:00:00",
  "tipo": "FISICA",
  "cpf": "12345678901",
  "identidade": "1234567"
}

Tratamento de retorno

Ausência de resposta JSON:resposta: lança exceção indicando que não houve resposta;resposta JSON; situação final 4 na tabela da fila de integração.
Resposta semvazia de success e sem message: tratada como retorno não reconhecido (exceção), situação 4.
Sucesso: quando success não está vazio, situação 2; caso contrário situação 4 com mensagem em message quando existir.
Em exceção genérica, a mensagem é persistida; se a mensagem indicar trecho após prefixo de JSON não reconhecido, o retorno estruturado pode incluir error e data com o conteúdotrecho analisado.

Notificação

A notificação de erros consulta registros com falha na tabela da fila de integração para o serviço LojaAjusteEstoqueLojaCliente e situação de erro, ordenando pelo horário de processamento para priorizar ocorrências mais antigas.

Endpoint (API)

O endpoint publicaprocessa o cadastro de cliente de varejo a bibliotecapartir parado instanciarcorpo dinamicamenteda asrequisição: classeso internas (por exemplo, capturador ou fila) via parâmetrofluxo de classeentrada é o array de parâmetros no padrãprocessamento principal, validado contra tipo e obrigatoriedade conforme o schema do serviço, com persistência em CLIENTES_VAREJO e regras de inclusão, atualização, filial e documento. O payload de entrada é um objeto JSON (ou equivalente) cujas chaves correspondem aos campos da plataforma.tabela Oao caminhofinal declaradoda subseção Estruturação de Dados; campos adicionais usados apenas no arquivofluxo dainterno biblioteca(CODIGO_CLIENTE, éTIPO_VAREJO, usadoOMS, comoentre baseoutros) dopodem recursoacompanhar HTTP.o mesmo corpo quando o chamador os informar.

Estruturação de Dados

ACampos invocaçadicionais tratados no fluxo interno de gravação segue (validação contratocomplementar e insert/update em CLIENTES_VAREJO): CODIGO_CLIENTE, TIPO_VAREJO, CADASTRAMENTO, DATA_PARA_TRANSFERENCIA, OMS, entre outros previstos no processamento de publicaçãopersistência.

Exemplo de payload enviado para o endpoint (JSON):

{
  "key": "<API_KEY_OU_VAZIO>",
  "class"CLIENTE_VAREJO": "Monitor"Nome do Cliente",
  "method"FILIAL": "run"01",
  "params"PF_PJ": []true,
  "ESTRANGEIRO": false,
  "CPF_CGC": "12345678901",
  "ENDERECO": "Rua Exemplo",
  "UF": "SP",
  "CEP": "01310100"
}

Tratamento de Dados

ONo carregamentométodo dinâmicode instanciagravação ado classecadastro em(pré-insert/update e persistência):

• CADASTRAMENTO, WOSK\LojaAjusteEstoque\DATA_PARA_TRANSFERENCIA: definidos com data/hora atual no início do processamento da requisição.
• TIPO_VAREJO: se não existir na lista carregada de CLIENTE_VAR_TIPOS, forçado para CLIENTE VAREJO.
• ESTRANGEIRO: se vazio, definido como 0; se UF conformefor EX, definido como 1.
• SEXO: se vazio, removido do conjunto de parâmetros antes da gravação.
• CEP: se informado e numericamente zero após avaliação, substituído por sentinela NULL() para o nomeinsert.
informado
• CODIGO_CLIENTE: se vazio após normalização, preenchido com CPF_CGC ou, para estrangeiro, com RG_IE; validação doespecífica segmentode recebido;obrigatoriedade e tamanho aplicada em seguida.
• Inclusão: verifica duplicidade de documento versus código para não háestrangeiro; transformaçconverte FILIAL numérica para nome via FILIAIS; prefixa OBS com texto fixo de origem PDV; executa insert parametrizado em CLIENTES_VAREJO conforme colunas previstas para o cadastro.
• Alteração: reaproveita CODIGO_CLIENTE, FILIAL, CADASTRAMENTO e TIPO_VAREJO do registro localizado; se OMS for diferente de 1, recalcula DATA_PARA_TRANSFERENCIA e aplica estratégia de mesclagem campo a campo conforme CADASTRAMENTO anterior antes do UPDATE; se OMS for 1, o bloco de atualização adicionalé ignorado.

Persistência no LINX

Chamada de persistência no banco LINX:

• Chamada: Operação em banco (insert ou update parametrizado).
• Tabelas: CLIENTES_VAREJO (principal); consultas auxiliares a CLIENTE_VAR_TIPOS e FILIAIS para listas e resolução de filial.
• Processamento: transação com commit ao sucesso ou rollback em falha; erros encapsulados com prefixo CLIENTES_VAREJO: na mensagem.

Tratamento de retorno

Sucesso: retorno com Mensagem igual a OK e Mensagem Detalhada indicando registro com sucesso, além dos campos CODIGO_CLIENTE, CADASTRAMENTO e DATA_PARA_TRANSFERENCIA atualizados no array de resposta.
Falha de validação inicial: exceção com mensagens concatenadas dos erros de campo.
Falha na gravação: exceção com mensagem originada do banco ou regra de negócio nesta(incluindo camadaconflito alémde documento/código).

O endpoint não implementa envio de notificação de erros; o acompanhamento de falhas da resoluçintegração daem classe.fila é tratado na Fila de Processamento.

Fluxo do Processo

Critérios de Aceitação