Movimentação Interna de Produto

Esta integração envia registros de perdas e avarias capturados no sistema RuB para o módulo de pendências de estoque do ERP RPInfo.

Identificação no RuB (Driver de Exportação)

Driver de Exportação (Writer): avaria_rpinfo
Nome da Interface: RPInfo (Configurações > MIP (Avaria))
Endpoint API: /v1.3/pendest/incluir ou /v1.4/pendest/incluir (Conforme configuração)

Funcionamento Geral

O processo é disparado automaticamente após a finalização de uma requisição de avaria (MIP) no RuB.
O sistema identifica a categoria do participante baseada na árvore de motivos.
Os dados são agrupados e enviados via protocolo HTTP POST no formato JSON.
A integração utiliza apenas o bloco de Inclusões na API do RPInfo.

Fluxo de Execução

graph TD
    A["Finalização de MIP (Avaria) no RuB"] --> B["Identificação do Motivo e Categoria"]
    B --> C["Determinar Categoria (UNIDADE, CLIENTE, FORNECEDOR, FUNCIONARIO, SEM_ENTIDADE)"]
    C --> D["Montar JSON Inclusoes com Itens, Motivo Pai e Filho"]
    D --> E{"Endpoint Configurado"}
    E -- " /v1.4/pendest/incluir " --> F["POST /v1.4/pendest/incluir"]
    E -- " /v1.3/pendest/incluir " --> G["POST /v1.3/pendest/incluir"]
    F --> H[("ERP RPInfo - Pendências de Estoque")]
    G --> H

Origem dos Dados no RuB

Os dados são extraídos do módulo de MIP (Avaria):

Processo: Finalização de requisição.
Entidade: RequisicaoAvaria e RequisicaoAvariaItem.

Detalhamento dos Campos (JSON)

Os campos abaixo são enviados dentro do objeto Inclusoes:

Campo RPInfo	Tipo	Origem RuB / Valor	Descrição
`dataMovimento`	Texto	`data_hora`	Data da ocorrência da avaria no RuB (dd/MM/yyyy).
`dataEntrega`	Texto	Data Atual	Data de envio do registro para o ERP (dd/MM/yyyy).
`unidadeOrigem`	Texto	`loja.cnpj`	CNPJ da unidade (loja) onde ocorreu a avaria.
`unidadeDestino`	Texto	`loja.cnpj`	Mesmo CNPJ da unidade de origem.
`tipoPendencia`	Texto	`motivo_pai`	Código do motivo pai direto da avaria (1º nível acima).
`codigoPendencia`	Texto	`motivo_codigo`	Código do motivo específico selecionado no RuB.
`especie`	Texto	Texto espécie MIP (rpinfoRextoEspecieMIP)	Texto fixo definido na configuração.
`codigoDocumento`	Texto	`codigo`	Número identificador (ID) da MIP no RuB.
`categoriaParticipante`	Texto	Categorias de participante	Mapeamento (UNIDADE, CLIENTE, FORNECEDOR, FUNCIONARIO) baseado nas configurações de categoria de motivo.
`participante`	Texto	`fornecedor`	Código do fornecedor (Obrigatório se categoria FORNECEDOR).
`pendencias`	Lista	(Lista)	Lista de itens que compõem a avaria.
└ `codigoProduto`	Texto	`produto`	Código interno do produto no RuB.
└ `quantidadeUnitaria`	Número	`qtd`	Quantidade total avariada.
└ `quantidadeEmbalagem`	Número	`0`	Valor fixo enviado como zero.
└ `valor`	Número	`0`	Valor fixo enviado como zero.

Hierarquia de Motivos

Para conformidade com o ERP RPInfo, o cadastro de motivos no RuB deve seguir uma estrutura hierárquica:

Nível Superior: Mapeado para o campo tipoPendencia.
Nível Selecionado: Mapeado para o campo codigoPendencia.
Nota: Em estruturas com mais de dois níveis, o sistema considera o motivo selecionado e seu pai imediato.

Categorias de Participante

A definição da categoria enviada ao ERP depende da vinculação do motivo raiz nas configurações avançadas do RuB:

Código do motivo para categoria Unidade (rpinfoMotivoCategoriaUnidade) -> UNIDADE
Código do motivo para categoria Cliente (rpinfoMotivoCategoriaCliente) -> CLIENTE
Código do motivo para categoria Fornecedor (rpinfoMotivoCategoriaFornecedor) -> FORNECEDOR
Código do motivo para categoria Funcionário (rpinfoMotivoCategoriaFuncionario) -> FUNCIONARIO

Regras de Negócio:

Em casos de ambiguidade, a prioridade segue a ordem da lista acima.
Se o motivo não estiver vinculado a nenhuma categoria, será enviado o valor SEM_ENTIDADE.
Para a categoria FORNECEDOR, o sistema busca automaticamente o código do fornecedor vinculado ao primeiro produto da lista de itens da MIP.

Configurações Avançadas e Aplicação

Acesse no RuB em Configurações > Configurações Avançadas > Integração > RPInfo:

Configuração (Chave)	Tipo	Padrão	Descrição e Como é Aplicada
Endpoint de envio de MIP (`configAvariaEndpoint`)	Enum	`/v1.4/pendest/incluir`	Define a rota de API utilizada para envio da pendência de estoque (`/v1.4/pendest/incluir`, `/v1.3/pendest/incluir` ou `/v1.3/pendest/pendenciaestoque`).
Texto espécie MIP (`rpinfoRextoEspecieMIP`)	Texto	Vazio	Texto estático enviado no campo `especie` do JSON de inclusão para classificação interna no ERP RPInfo.
Motivo Categoria Unidade (`rpinfoMotivoCategoriaUnidade`)	Texto	Vazio	Lista de códigos de motivo raiz (separados por vírgula) que classificam a avaria como `UNIDADE`.
Motivo Categoria Cliente (`rpinfoMotivoCategoriaCliente`)	Texto	Vazio	Lista de códigos de motivo raiz (separados por vírgula) que classificam a avaria como `CLIENTE`.
Motivo Categoria Fornecedor (`rpinfoMotivoCategoriaFornecedor`)	Texto	Vazio	Lista de códigos de motivo raiz (separados por vírgula) que classificam a avaria como `FORNECEDOR` (preenche automaticamente o campo `participante` com o código do fornecedor do item).
Motivo Categoria Funcionário (`rpinfoMotivoCategoriaFuncionario`)	Texto	Vazio	Lista de códigos de motivo raiz (separados por vírgula) que classificam a avaria como `FUNCIONARIO`.

Ativação

A ativação deve ser realizada em Configurações > MIP (Avaria), selecionando a interface RPInfo.