Integração ERP
O vendedor está com uma cotação aberta no seu ERP. Esta seção descreve como levá-lo ao catálogo Sipru sem pedir login, e como o que ele monta lá volta para o seu sistema.
Os dois modos
Eles não são exclusivos — o canal ao vivo é o handoff mais o empurrão de produtos.
Handoff SSO
O ERP pede uma URL de entrada e redireciona o navegador do vendedor. Ele cai no catálogo Sipru já logado na conta real dele, com a cotação e o cliente anexados. Monta o carrinho no Sipru, e o pedido volta gravado no seu banco.
→ Handoff SSO · Pedido gravado no seu banco
Canal ao vivo
Além do handoff, abre-se um canal por cotação. Quando o vendedor digita um código no ERP, o ERP avisa o Sipru e o produto aparece sozinho na tela, com as recomendações. O vendedor não digita duas vezes, e cada item entra no seu sistema no clique de "adicionar".
→ Canal ao vivo · Item adicionado ao carrinho
Por onde o pedido volta
É a diferença que mais confunde na primeira leitura, então vale explicitar: os dois modos devolvem o pedido por caminhos diferentes.
| Modo | Quando o seu sistema é avisado | Como |
|---|---|---|
| Handoff SSO | uma vez, no fechamento do carrinho | gravação na tabela pedido_sipru do seu banco |
| Canal ao vivo | a cada item, no clique de "adicionar" | POST no seu endpoint HTTP |
Credenciais
Toda chamada server-to-server exige as duas credenciais juntas:
X-Sipru-Partner-Id: seu-partner-id
Authorization: Bearer <segredo do parceiro>
O segredo é emitido pelo time Sipru e guardado do nosso lado apenas como hash — ele é exibido uma única vez, na emissão ou na rotação. Se for perdido, o caminho é rotacionar, não recuperar.
Essas credenciais são de servidor. Elas não podem aparecer em código client-side, aplicativo distribuído ou repositório.
Ambientes
| Ambiente | Base URL |
|---|---|
| Produção | https://app.sipru.ai |
| Homologação | https://dev.sipru.ai |
Independentemente do ambiente Sipru que você chamar, qual banco do seu ERP recebe a
gravação do pedido é decidido pelo campo environment do corpo da requisição — e só o
literal "prd" seleciona a base real. Campo ausente ou qualquer outro valor significa
sandbox. Isso é deliberado: um campo esquecido nunca escreve na sua base de produção.
Referência completa
O contrato formal de todos os endpoints está em Referência da API — ver também o contrato OpenAPI.