D-1 R1 Integração - Proteus

INTEGRAÇÃO BITRIX24 x PROTHEUS

A integração Bitrix24 x Protheus automatiza o fluxo comercial entre o CRM e o ERP, garantindo sincronização de orçamentos, pedidos, estoque e faturamento. O processo é conduzido por meio de APIs e executado em etapas, mantendo os status sempre atualizados no Bitrix24.

ESCOPO DA INTEGRAÇÃO

1) Criação do Card de Negociação no Bitrix24
- O card é criado utilizando um cliente previamente cadastrado no Protheus e já importado para o Bitrix24.
- São informados os dados obrigatórios para geração do orçamento no Protheus.
- As informações são preenchidas com base em amarrações entre cadastros existentes.

2) Envio e Inclusão do Orçamento no Protheus
- O envio ocorre automaticamente ao salvar o card de negociação no Bitrix24.
- A integração realiza requisição à API do Protheus para inclusão do orçamento.
- Informações obrigatórias:
  - Tabela de Preços: vinculada ao cliente. Caso não exista, utiliza-se o preço de venda do cadastro do produto.
  - TES (Tipos de Entradas e Saídas): preenchido automaticamente conforme regras do Protheus.
- Em caso de erro:
  - O card permanece na etapa de negociação.
  - O status indica a falha até nova tentativa de integração.

3) Retorno do Orçamento Atualizado
- Após sucesso na integração, o Protheus retorna:
  - Código do orçamento.
  - Valores atualizados dos produtos.
  - Informações de impostos (quando aplicável).
- O status do card passa para “Orçamento Colocado”.

4) Conversão para Pedido de Venda
- Ao concluir a negociação no Bitrix24:
  - O orçamento é convertido em pedido de venda no Protheus.
  - As quantidades são liberadas e o estoque é reservado.
- Status possíveis:
  - Pedido de Venda Liberado Parcial: quando há falta de estoque.
  - Pedido de Venda Liberado Total: quando todos os itens estão disponíveis.
- Em caso de estoque insuficiente:
  - O Bitrix24 envia e-mail automático ao setor de compras.

PROCESSOS EXECUTADOS NO PROTHEUS

Processo de Compras
- Ocorre integralmente no Protheus.
- Utilizado quando há falta de estoque.
- O status permanece como “Pedido de Venda Liberado Parcial” até a regularização.

Faturamento
- Emissão das notas fiscais ocorre no Protheus.
- Pode ocorrer de forma parcial ou total:
  - Faturado Parcial
  - Faturado Total (encerramento do ciclo)

IMPORTAÇÕES NECESSÁRIAS

1) Importação de Clientes
- Cadastro importado do Protheus para o Bitrix24 antes da operação.
- O Protheus é o sistema mandatário.
- Novos clientes devem ser cadastrados manualmente em ambos os sistemas.

2) Importação de Condições de Pagamento
- Dados importados do Protheus para o Bitrix24.
- O Protheus permanece como sistema principal.
- Novos registros devem ser incluídos manualmente nos dois sistemas.

INTEGRAÇÕES COMPLEMENTARES

1) Integração de Produtos e Estoque
- Sincronização periódica de produtos e saldos de estoque.
- Executada em intervalos definidos.
- Garante que o Bitrix24 trabalhe com dados atualizados.

2) Atualização de Status da Negociação
- Consulta automática ao Protheus em intervalos programados.
- Status possíveis no Bitrix24:
  - Orçamento Colocado
  - Pedido de Venda Liberado Parcial
  - Pedido de Venda Liberado Total
  - Faturado Parcial
  - Faturado Total

PRÉ-REQUISITOS
- Conector de integração (iPaaS).
- Acesso ao ambiente do Protheus.
- Disponibilização de:
  - Tokens, webhooks ou acessos às APIs.
  - Endpoints de integração.
  - Mapeamento de campos entre os sistemas.

MODELO DE CONTRATAÇÃO
- Desenvolvimento da integração: R$ 17.000,00 pagamento único.
- Conector (iPaaS): R$ 600,00 mensal, enquanto a integração estiver ativa.
- Limite padrão do conector: até 100.000 execuções mensais.