Kit do Fabricante Piloto | Integração Ariana Enterprise

Fluxo oficial do piloto

O fabricante não entra direto em Produção. Cada etapa tem um objetivo claro e a liberação final depende da homologação técnica completa.

1

Contato comercial

Apresentação da Ariana Enterprise e confirmação do interesse.

2

Qualificação

Empresa, categorias, ERP, volume de SKUs, operação fiscal e logística.

3

Solicitação

Cadastro formal de homologação com responsáveis comercial e técnico.

4

Sandbox

API Key, OAuth e segredos entregues uma única vez para integração segura.

5

Homologação 100%

Catálogo, pedidos, fiscal, rastreio, webhooks, cancelamento e RMA.

6

Produção

Credencial de Produção liberada somente após evidências reais aprovadas.

7

Go-live assistido

Lote inicial controlado, monitoramento e expansão do catálogo após estabilidade.

Checklist comercial antes de chamar o TI

Essas informações evitam começar uma integração tecnicamente correta com uma operação comercial ainda indefinida.

Empresa e responsáveis

✓

Razão social, nome fantasia e CNPJDados da empresa que será homologada.

✓

Responsável comercialNome, telefone e e-mail para decisões de negócio.

✓

Responsável técnico / TIPessoa que receberá as credenciais e conduzirá a integração.

✓

ERP ou plataforma utilizadaNome do ERP, integrador ou sistema próprio.

Operação do fabricante

✓

Categorias e marcasQuais linhas serão disponibilizadas no marketplace.

✓

Quantidade aproximada de SKUsAjuda a definir a estratégia de carga inicial e sincronização.

✓

Faturamento e NF-eCapacidade de devolver número, série, chave, XML e DANFE por pedido.

✓

Logística e rastreioTransportadora, código/link de rastreio e fluxo de devolução.

✓

Condições comerciais formalizadasComissão, pagamentos, frete, devoluções e responsabilidades são definidos no acordo comercial antes do go-live.

Pacote para a equipe de TI

Estas são as informações que o fabricante precisa receber assim que o Sandbox for aprovado.

Dados técnicos essenciais

v1 estávelSandbox isoladoHTTPSOAuth 2.0HMAC

Base URL estável: https://ariana-backend.onrender.com/api/v1/enterprise Autenticação: x-ariana-key: <API_KEY_SANDBOX> Alternativa corporativa: OAuth 2.0 Client Credentials Catálogos grandes: POST /catalog/sync Idempotência de pedidos: Idempotency-Key: <identificador único do pedido> Webhooks: HTTPS + assinatura HMAC + retry automático

Links oficiais para enviar ao TI

Documentação interativaGuia de autenticação, payloads, endpoints e erros.

Abrir

API ExplorerExecuta o fluxo real de homologação no Sandbox.

Abrir

Swagger / OpenAPIContrato técnico da API para desenvolvimento.

Abrir

SDK OficialPacotes para linguagens e ERPs compatíveis.

Abrir

Portal do FabricanteLogs, consumo, chaves, webhooks e operação.

Abrir

Checklist técnico obrigatório da homologação

A Ariana Enterprise calcula a homologação pelas chamadas realmente executadas no Sandbox. Marcar uma etapa manualmente não substitui a evidência da API.

Catálogo e produto

1

AutenticaçãoAPI Key ou OAuth válido no Sandbox.

2

CatálogoCadastro/sincronização de SKUs com dados válidos.

3

EstoqueAtualização de disponibilidade por SKU.

4

PreçoAtualização de preço por SKU.

Pedido e fiscal

5

PedidoCriação/recebimento com idempotência.

6

NF-eNúmero, série, chave e total.

7

XMLXML da nota disponível e consultável.

8

DANFEDANFE disponível e consultável.

Pós-venda e eventos

9

RastreioTransportadora, código e URL de acompanhamento.

10

WebhookRecepção HTTPS com assinatura HMAC.

11

CancelamentoFluxo de cancelamento homologado.

12

Devolução / RMAAbertura e tratamento do retorno.

Regra de Produção: a liberação só ocorre com homologação real em 100%. A API Key de Produção é gerada apenas nesse momento e o segredo completo é exibido uma única vez.

Go-live do primeiro fabricante

Mesmo com a integração aprovada, a primeira entrada deve ser controlada para reduzir impacto operacional.

Antes de ativar

✓

Homologação em 100%Sem etapas técnicas pendentes.

✓

Credencial de Produção entregue ao TIGuardada em cofre/secret manager, nunca em código ou planilha pública.

✓

Webhook de Produção configuradoURL HTTPS validada e assinatura conferida.

✓

Contatos de contingência definidosResponsável Ariana + responsável técnico e comercial do fabricante.

Ativação recomendada

1

Lote inicial controladoComeçar com uma seleção reduzida de produtos, por exemplo 50–200 SKUs, antes do catálogo inteiro.

2

Monitorar catálogo, estoque e preçoConfirmar que atualizações do ERP chegam sem divergências.

3

Acompanhar os primeiros pedidosPedido, NF-e, rastreio e webhook devem fechar o ciclo completo.

4

Expandir o catálogoDepois da estabilidade operacional, liberar o restante do mix.

Importante: Sandbox e Produção usam credenciais diferentes. Dados de teste permanecem isolados e não devem ser reutilizados como dados comerciais reais.

Mensagem pronta para enviar ao TI do fabricante

Você pode copiar e enviar junto com as credenciais Sandbox geradas na aprovação.

Olá! Sua empresa foi aprovada para iniciar a homologação no Sandbox da Ariana Enterprise. A integração deve ser feita usando a API v1 estável: https://ariana-backend.onrender.com/api/v1/enterprise Materiais oficiais: • Kit do Fabricante Piloto: https://arianamoveis.com.br/kit_fabricante_piloto.html • Documentação: https://arianamoveis.com.br/ariana_enterprise_docs.html • API Explorer: https://arianamoveis.com.br/enterprise_api_explorer.html • Swagger/OpenAPI: https://arianamoveis.com.br/enterprise_swagger.html • SDKs: https://arianamoveis.com.br/ariana_enterprise_sdk.html • Portal do Fabricante: https://arianamoveis.com.br/fabricante_login.html As credenciais Sandbox são exclusivas da sua empresa. Não envie API Keys ou Client Secrets por repositórios públicos. Para liberação em Produção, o fluxo de homologação precisa atingir 100% com evidências reais no Sandbox: catálogo, estoque, preço, pedido, NF-e, XML, DANFE, rastreio, webhook, cancelamento e devolução/RMA. Em caso de dúvida técnica, responda ao contato da equipe Ariana responsável pela sua homologação.