ERP enterprise: SAP e NetSuite

Guia passo a passo para conectar o Sellio ao seu SAP (OData) ou NetSuite (REST) de forma bidirecional: enviar contas, pedidos e faturas ao ERP e receber de volta os eventos (fatura paga, pedido/cliente atualizado). Modelo BYO: o ERP e as credenciais são seus.

Esta integração conecta o Sellio ao seu ERP corporativo (SAP via OData ou NetSuite via REST Record Service) de forma bidirecional e profunda. É complementar ao conector "ERP / Faturamento" genérico (que só faz um POST simples a um endpoint): aqui falamos diretamente com a API tipada de cada plataforma, com a autenticação real de cada uma. Modelo BYO: a conta e as credenciais são suas; não há custo nosso. Tudo nasce inerte: nada é enviado ou recebido até você configurar e ativar. Os segredos ficam cifrados e nunca são exibidos de volta.

O que acontece em cada direção: no ENVIO (Sellio → ERP), quando você dispara (ou uma automação dispara) o CRM monta o registro na linguagem do ERP (EntitySet do OData no SAP; recordType no NetSuite) e faz o POST autenticado. No RECEBIMENTO (ERP → Sellio), o seu ERP chama a URL de webhook do Sellio a cada evento (fatura paga, pedido atualizado, cliente atualizado); o Sellio concilia um pagamento pendente pelo valor + moeda (quando é uma fatura/pedido pago) ou registra uma atividade no Contato correspondente. Eventos repetidos são deduplicados pelo id externo.

1. Pré-requisitos

SAP (S/4HANA Cloud, S/4HANA on-premise via SAP Gateway, ou SAP BTP): você precisa de um serviço OData publicado para as entidades que vai sincronizar (por exemplo, o serviço padrão API_BUSINESS_PARTNER para contas/contatos, API_SALES_ORDER_SRV para pedidos, API_BILLING_DOCUMENT_SRV para faturas) e de uma credencial para chamá-lo. Duas opções de credencial: (a) um Usuário de Comunicação (Communication User) com Basic Auth, ou (b) um cliente OAuth 2.0 (client credentials) no SAP BTP. Permissões: o usuário/cliente precisa de autorização de criação (POST) nas entidades OData escolhidas.

NetSuite (SuiteTalk REST): você precisa do recurso "SuiteTalk (SOAP and REST Web Services)" e do "Token-Based Authentication" habilitados na sua conta, e de um usuário com um papel (Role) que tenha as permissões de Lists/Records dos objetos que vai sincronizar (Customers, Sales Orders, Invoices) e a permissão "REST Web Services" (em Setup). Você vai criar um Integration Record (Consumer Key/Secret) e um Access Token (Token ID/Secret).

• Você precisa ser administrador do Sellio (permissão de gerir configurações) para salvar e ativar o conector.
• Tenha à mão as URLs/IDs: no SAP, a URL base do serviço OData; no NetSuite, o seu Account ID (ex.: 1234567, ou 1234567_SB1 para sandbox).

2. No provedor, SAP (expor o OData e criar a credencial)

1. Publique/ative o serviço OData da entidade desejada. Em S/4HANA on-premise, use a transação /IWFND/MAINT_SERVICE para adicionar e ativar o serviço (ex.: API_BUSINESS_PARTNER); anote a URL base resultante (algo como https://seuhost:44300/sap/opu/odata/sap/API_BUSINESS_PARTNER). No S/4HANA Cloud, o serviço já é publicado; copie a Service URL do Communication Arrangement correspondente.
2. Crie a credencial de comunicação. Para Basic Auth: em Communication Management → Maintain Communication Users, crie um Communication User com usuário e senha; depois, em Communication Arrangements, associe esse usuário ao cenário de comunicação (Communication Scenario) que expõe o serviço OData. Para OAuth 2.0 (BTP): crie uma instância do serviço e anote o Client ID, o Client Secret e a Token URL (endpoint /oauth/token).
3. Garanta que o usuário/cliente tem permissão de POST (criação) nas entidades. Teste rapidamente o GET da coleção no navegador/Postman com a mesma credencial para confirmar o acesso.

2. No provedor, NetSuite (Integration Record + Access Token TBA)

1. Habilite os recursos: Setup → Company → Enable Features → aba SuiteCloud → marque "SOAP Web Services" e/ou "REST Web Services" e "Token-Based Authentication". Salve.
2. Crie o Integration Record: Setup → Integration → Manage Integrations → New. Dê um nome (ex.: "Sellio CRM"), deixe "Token-Based Authentication" marcado, desmarque "TBA: Authorization Flow" e "OAuth 2.0" se for usar só TBA, e salve. O NetSuite mostra UMA ÚNICA VEZ o Consumer Key e o Consumer Secret; copie os dois agora (não são exibidos de novo).
3. Crie o Access Token: Setup → Users/Roles → Access Tokens → New. Selecione a Application Name (o Integration Record que você criou), o User e o Role (um papel com as permissões de Records + "REST Web Services"). Salve. O NetSuite mostra UMA ÚNICA VEZ o Token ID e o Token Secret; copie os dois agora.
4. Anote o seu Account ID: Setup → Company → Company Information (campo "Account ID"), ex.: 1234567 (produção) ou 1234567_SB1 (sandbox).

3. No Sellio: colar as credenciais e ativar

1. Abra Configurações → Integrações e localize o cartão "SAP (ERP enterprise)" ou "NetSuite (ERP enterprise)".
2. SAP: em "URL do serviço OData", cole a URL base do serviço (sem a barra final e sem o nome do EntitySet, pois o Sellio anexa o EntitySet correto). Em "Tipo de autenticação", escolha Basic (e cole Usuário + Senha) ou OAuth 2.0 (e cole a URL do token + Client ID + Client Secret).
3. NetSuite: em "Account ID", cole o seu ID (ex.: 1234567 ou 1234567_SB1). Em "Tipo de autenticação", escolha Token-Based Authentication (TBA) e cole Consumer Key, Consumer Secret, Token ID e Token Secret. (Se preferir OAuth 2.0, escolha essa opção e cole o Access Token.)
4. Preencha o "Segredo do webhook" se você for enviar eventos do ERP de volta ao Sellio. Ele é OBRIGATÓRIO para o recebimento: por segurança (os eventos podem quitar um pagamento), o Sellio só aceita webhooks com esse segredo/assinatura; sem ele, o recebimento é recusado (veja o passo 4). Fica cifrado.
5. Clique em "Salvar conector". As credenciais são guardadas cifradas. Depois clique em "Ativar": o envio e o recebimento só funcionam com o conector ATIVADO.

Para receber eventos do ERP: depois de salvar, use "Gerar URL do webhook" e copie a URL (formato https://app.../api/inbound/erp/SEU_TOKEN). Cole essa URL no destino de webhook do seu ERP: no SAP, em uma automação/middleware (Event Mesh, SAP BTP, ou um job que faça POST); no NetSuite, em um User Event Script/RESTlet ou numa ferramenta de automação (SuiteFlow + script) que faça POST do evento. O provider (SAP ou NetSuite) é identificado pelo próprio token; não há nada a escolher na URL.

4. Como testar

1. Com o conector ativado, clique em "Enviar registro de teste" no cartão. O Sellio monta uma conta fictícia ("Sellio CRM Connection Test") e a envia ao seu ERP.
2. Confira no ERP: no SAP, procure o Business Partner recém-criado na entidade correspondente; no NetSuite, procure o Customer novo em Lists → Relationships → Customers.
3. Se aparecer "Registro de teste enviado ao ERP", a autenticação e o endpoint estão corretos. Depois, para o envio de um registro REAL, dispare o envio a partir do registro do CRM (conta, contato, pedido, oportunidade ou fatura): o Sellio usa o mesmo caminho.
4. Para testar o RECEBIMENTO: gere no ERP (ou simule) um evento (por exemplo, marque uma fatura como paga) e verifique no Sellio se um pagamento pendente de mesmo valor foi conciliado, ou se surgiu uma atividade no Contato correspondente.

5. Solução de problemas

• 401 (não autorizado): credenciais erradas ou expiradas. SAP Basic → confira usuário/senha do Communication User; SAP OAuth → confira Client ID/Secret e a URL do token; NetSuite TBA → confira Consumer Key/Secret e Token ID/Secret (um caractere a mais/menos invalida a assinatura). Recole os segredos (eles não voltam do servidor por segurança).
• Assinatura TBA inválida (NetSuite): a Token-Based Authentication usa OAuth 1.0a com HMAC-SHA256; a assinatura depende do método, da URL exata (incluindo parâmetros de query) e do Account ID (realm). Confirme que o Account ID está correto (com o sufixo _SB1 no sandbox) e que os quatro valores (Consumer Key/Secret, Token ID/Secret) foram colados sem espaços. Se você regenerou o token no NetSuite, atualize-o no Sellio.
• 403 (proibido): a credencial autentica, mas o papel/usuário não tem permissão para criar aquele registro. No NetSuite, revise as permissões do Role (Lists/Records + "REST Web Services"); no SAP, revise a autorização de POST na entidade OData / o Communication Scenario.
• Entidade/recordType não encontrado (404): no SAP, a URL do serviço OData está errada ou o serviço não está ativado: confirme a URL base (sem o EntitySet) e ative o serviço em /IWFND/MAINT_SERVICE. No NetSuite, o recordType padrão pode não corresponder ao seu, e contas/pedidos/faturas customizados podem exigir um recordType diferente (fale com o suporte para ajustar o mapeamento).
• Campos rejeitados: SAP e NetSuite são estritos com os nomes das propriedades. O Sellio envia um conjunto conservador de campos comuns (nome, e-mail, telefone, empresa, valor, moeda, referência). Se o seu ERP exige campos obrigatórios adicionais (ex.: BP Category no SAP, subsidiary no NetSuite), eles precisam ser mapeados; ajuste o mapeamento na configuração ou fale com o suporte.
• Webhook não chega (recebimento): confirme que o conector está ATIVADO (webhook de conector desativado responde 404), que a URL colada no ERP está completa (com o token) e, se você definiu um "Segredo do webhook", que o ERP envia o segredo no header X-Sellio-Secret ou o HMAC-SHA256 do corpo no header de assinatura; caso contrário a resposta é 401.

Abrir este artigo dentro do sistema →