EXATA Ajuda EXATA

Integração Bitrix

Rev 25.0826.1

Documentação de Integração SEAC - Bitrix

Introdução

Esta documentação descreve o processo de integração entre o sistema SEAC (Sistema EXATA de Automação Comercial) e a plataforma Bitrix, com foco na sincronização de propostas/orçamentos.

A integração permite que as propostas criadas ou atualizadas no SEAC sejam refletidas no Bitrix, e que alterações de status realizadas diretamente no Bitrix sejam sincronizadas de volta para o SEAC.

Público-alvo: Times SEAC, clientes que utilizam o ERP e time Bitrix.

Visão Geral da Integração

Processo de Integração

  1. Novo orçamento: Ao salvar um novo orçamento no SEAC, é enviado para o Bitrix com status "Novo".
  2. Atualização de orçamento: Ao atualizar um orçamento existente, é enviado uma atualização para o Bitrix.
  3. Alteração de Status no SEAC: Quando o vendedor/gerente altera o status de um orçamento no SEAC, uma nova atualização é enviada ao Bitrix.
  4. Recusa de um orçamento: Quando um orçamento é recusado no SEAC, é enviado enviar uma atualização para o Bitrix informando que a Proposta foi recusada.
  5. Proposta efetivada na loja: Quando um orçamento é convertido em venda, o módulo PDV(NFCe) do SEAC enviar para o Bitrix o orçamento com o novo status de Aceita.
  6. Proposta já aceita cancelada: Quando uma venda de um orçamento for cancelada no PDV(NFCe), o SEAC envia para o Bitrix o orçamento com o status Novo.

Validação de Entrada

  1. Reprocessamento: Diariamente às 4h, o SEAC reprocessa propostas do dia anterior verificando possíveis propostas não processadas.
  2. Sincronização de propostas perdidas: Às 4h, o SEAC consulta e sincroniza propostas marcadas como perdidas no Bitrix

Integração com Origem no Bitrix

  • O Bitrix envia via webhook as alterações de status realizadas em sua plataforma
  • Quando status é alterado para "Recusada", o Bitrix envia para o SEAC
  • O SEAC então recusa a proposta correspondente

Importante
Como é uma ação originada no Bitrix, em caso de instabilidade e falha no envio, o SEAC não terá como saber que a proposta foi recusada.

Considerações Finais

  • A integração garante a sincronização bidirecional de propostas entre SEAC e Bitrix
  • Processos automatizados garantem a consistência dos dados mesmo em caso de falhas pontuais
  • É importante monitorar os logs de integração para identificar possíveis problemas
  • Em caso de dúvidas técnicas, contate o time de desenvolvimento SEAC

FAQ

Perguntas Frequentes

1. Tenho um orçamento mais antigo no SEAC mas não aparece no Bitrix. O que pode ser?
Se é um orçamento com mais de um dia no SEAC, pode ser que ele tenha sido excluído diretamente no site da Bitrix.
Nunca apague um orçamento direto pelo Bitrix.
Solicite a pessoa responsável do Time Comercial que faça uma intervenção manual para ajustar o problema.
2. Tenho um orçamento Aceito no Bitrix mas no SEAC está diferente. O que aconteceu?
Um orçamento na coluna Aceito no Bitrix e com status diferente no SEAC, pode ter sido movido acidentalmente por você para a coluna Aceita.
Nunca mova um orçamento para a coluna Aceita no Bitrix. Quando um orçamento é convertido em venda no SEAC, ele automaticamente vai para Aceito no Bitrix.
Solicite a pessoa responsável do Time Comercial que faça uma intervenção manual para ajustar o problema.
3. Recusei o orçamento direto no Bitrix mas no SEAC ainda está em Aberto. O que houve?
Quando você move um card de orçamento para a coluna Recusada, imediatamente o Bitrix envia um "sinal" para o SEAC indicando o novo status de Recusado. O SEAC vai processar esse sinal imediatamente. Se após 1 minuto não mudar nada no SEAC, significa que excepcionalmente o Bitrix não conseguiu enviar o sinal para o SEAC.
Em casos como esse, você vai precisar aguardar até o dia seguinte e verificar novamente. Todos as manhãs, o SEAC faz uma verificação de tudo o que foi alterado no Bitrix no dia anterior. Caso o orçamento esteja Recusado no Bitrix e não está no SEAC, é nesse momento que tudo se resolve.
Caso o problema persista, mesmo após o dia seguinte, solicite a pessoa responsável do Time Comercial que faça uma intervenção manual para ajustar o problema.
4. Recuperei um orçamento que estava Recusado no Bitrix e movi para a coluna Novo. Não mudou nada no SEAC e continua como Recusado. O que eu faço?
Essa é uma situação identica a questão 3 (logo acima). Siga os mesmos passos.
5. Tenho um orçamento no SEAC que não está no Bitrix. Como eu localizo ele no Bitrix?
Sempre que você clica no botão Salvar na tela de orçamento no SEAC, ele envia o orçamento para o Bitrix. Esse processo é quase instantaneo e não leva mais que 1 minuto. Caso você não esteja visualizando ele no Bitrix, pode ter ocorrido uma exceção no envio (Falha na internet, servidor Bitrix offline, etc). Você pode tentar fazer uma alteração no orçamento e tentar enviar novamente. Caso não apareça, comunique a pessoa responsável do Time Comercial e aguarde até o dia segunte para ver se vai aparecer.

Informações de Regras de Negócio e Técnica

Daqui em diante segue os detalhes mais técnicos e detalhados da integração.

Fluxo de Integração

Etapas do Processo

1. Criação/atualização do contato Vendedor no Bitrix
Rota: https://cliente.bitrix24.com.br/rest/1/y97i674gqgxzrui6/crm.contact.add
JSON Exemplo:
{
  "fields": {
    "ADDRESS": "AVENIDA BRASILIA, 110 CASA 1",
    "ADDRESS_2": "",
    "ADDRESS_CITY": "RIO DAS OSTRAS",
    "ADDRESS_POSTAL_CODE": 28895538,
    "ADDRESS_PROVINCE": "JARDIM BELA VISTA",
    "ADDRESS_REGION": "RJ",
    "EMAIL": [{"VALUE": "rafael@cliente.com.br", "VALUE_TYPE": "Contato"}],
    "LAST_NAME": "COSTA DA SILVA",
    "NAME": "RAFAEL",
    "ORIGIN_ID": 679,
    "PHONE": [{"VALUE": "5522999999999", "VALUE_TYPE": "Contato"}],
    "TYPE_ID": "UC_DQ98J9",
    "UF_CRM_1708341257899": "49157607079",
    "UF_CRM_1721140698879": 679
  },
  "id": 25
}
2. Criação/atualização do contato Profissional no Bitrix
Rota: https://cliente.bitrix24.com.br/rest/1/y97i674gqgxzrui6/crm.contact.add
JSON Exemplo:
{
  "fields": {
    "ADDRESS": "AVENIDA BRASILIA, 110 CASA 1",
    "ADDRESS_2": "",
    "ADDRESS_CITY": "RIO DAS OSTRAS",
    "ADDRESS_POSTAL_CODE": 28895538,
    "ADDRESS_PROVINCE": "JARDIM BELA VISTA",
    "ADDRESS_REGION": "RJ",
    "EMAIL": [{"VALUE": "rafael@cliente.com.br", "VALUE_TYPE": "Contato"}],
    "LAST_NAME": "COSTA DA SILVA",
    "NAME": "RAFAEL",
    "ORIGIN_ID": 679,
    "PHONE": [{"VALUE": "5522999999999", "VALUE_TYPE": "Contato"}],
    "TYPE_ID": "PARTNER",
    "UF_CRM_1708341257899": "49157607079",
    "UF_CRM_1721140698879": 679
  },
  "id": 25
}
3. Criação/atualização do contato Cliente no Bitrix
Rota: https://cliente.bitrix24.com.br/rest/1/y97i674gqgxzrui6/crm.contact.add
JSON Exemplo:
{
  "fields": {
    "ADDRESS": "AVENIDA BRASILIA, 110 CASA 1",
    "ADDRESS_2": "",
    "ADDRESS_CITY": "RIO DAS OSTRAS",
    "ADDRESS_POSTAL_CODE": 28895538,
    "ADDRESS_PROVINCE": "JARDIM BELA VISTA",
    "ADDRESS_REGION": "RJ",
    "EMAIL": [{"VALUE": "rafael@cliente.com.br", "VALUE_TYPE": "Contato"}],
    "LAST_NAME": "COSTA DA SILVA",
    "NAME": "RAFAEL",
    "ORIGIN_ID": 679,
    "PHONE": [{"VALUE": "5522999999999", "VALUE_TYPE": "Contato"}],
    "TYPE_ID": "CLIENT",
    "UF_CRM_1708341257899": "49157607079",
    "UF_CRM_1721140698879": 679
  },
  "id": 25
}
4. Criação/atualização da Proposta (Dados Master) no Bitrix
Rota: https://cliente.bitrix24.com.br/rest/1/y97i674gqgxzrui6/crm.deal.add
JSON Exemplo:
{
  "fields": {
    "ASSIGNED_BY_ID": 19,
    "BEGINDATE": "2025-08-25 16:31:42",
    "CLOSED": "Y",
    "CLOSEDATE": "2025-11-23 16:31:42",
    "COMPANY_ID": 1,
    "CONTACT_ID": 25,
    "OPENED": "Y",
    "OPPORTUNITY": 87.8000,
    "ORIGIN_ID": 1437358,
    "STAGE_ID": "NEW",
    "STAGE_SEMANTIC_ID": "P",
    "TAX_VALUE": 0.0000,
    "TITLE": "Proposta nº 1437358",
    "UF_CRM_1708118356": 25,
    "UF_CRM_1708118943": null,
    "UF_CRM_1708345214587": "DINHEIRO - ACABAMENTOS (15%)",
    "UF_CRM_1708345391895": "",
    "UF_CRM_1708346099314": "0,00",
    "UF_CRM_1708352491561": "0,00",
    "UF_CRM_1708451173707": "",
    "UF_CRM_1708946200509": "157757",
    "UF_CRM_1721140457603": 1437358,
    "UF_CRM_1727182622336": "",
    "UF_CRM_1727182756362": null,
    "lo_codigo": 1
  }
}
5. Criação/atualização dos produtos da Proposta no Bitrix
Rota: https://cliente.bitrix24.com.br/rest/1/y97i674gqgxzrui6/crm.deal.productrows.set
JSON Exemplo:
{
  "id": 281335,
  "rows": [
    {
      "PRODUCT_ID": 19,
      "PRICE": 87.8000,
      "QUANTITY": 1,
      "DISCOUNT_SUM": 15.5000
    }
  ]
}
6. Marcação do orçamento no SEAC como integrado ao Bitrix
Marca internamente no SEAC como integrado com sucesso somente se as 5 etapas anteriores foram enviadas com sucesso.

Observação: Se qualquer etapa falhar, o orçamento ficará marcado como não integrado no SEAC e será reprocessado na próxima execução automática.

Status da Proposta

O status de uma proposta no SEAC define como a mesma será enviado ao Bitrix.
Abaixo segue o detalhamento de cada status e como é enviado:

1. Proposta aberta no SEAC:
'STAGE_ID = 'NEW' | OPENED = 'Y' | CLOSED = 'Y' | STAGE_SEMANTIC_ID = 'P''
2. Proposta aceita no SEAC:
'STAGE_ID = 'WON' | OPENED = 'Y' | CLOSED = 'Y' | STAGE_SEMANTIC_ID = 'S''
3. Proposta recusada no SEAC:
'STAGE_ID = 'LOSE' | OPENED = 'N' | CLOSED = 'N' | STAGE_SEMANTIC_ID = 'F''

Consulta de Propostas Perdidas

Consulta utilizada para sincronização de propostas perdidas:

crm.deal.list?filter[STAGE_ID]=LOSE&filter[>=MOVED_TIME]=@data&select[]=UF_CRM_1721140457603&order[UF_CRM_1721140457603]=DESC&start=

Documentação de Integração SEAC - Bitrix