A API do Navitrine deixa o sistema da sua loja conversar com a vitrine: publicar o\ncatálogo, manter preço e disponibilidade em dia e receber os pedidos que os clientes\nfizerem.
\nEla é feita para ser usada por quem já tem um sistema — ERP, PDV, cardápio digital —\ne quer que ele seja a fonte do que aparece na vitrine.
\nGET /me. A resposta diz de qual loja é o\ntoken e o que ele pode fazer.curl https://api.navitrine.app/api/v1/me \\\n -H \"Authorization: Bearer \"\nVocê não precisa de um lojista para começar. Crie sua conta e saia com a credencial:
\ncurl -X POST https://api.navitrine.app/api/v1/dev/registrar \\\n -H \"Content-Type: application/json\" \\\n -d '{\"nome\":\"ERP da Silva\",\"email\":\"dev@erpdasilva.com.br\",\"password\":\"uma-senha-boa-2026\"}'\nA resposta traz uma credencial nvt_test_ e uma loja de testes: uma loja de\nmentira que não aparece na vitrine, não é cobrada e não avisa lojista nenhum. É onde\nvocê erra à vontade — sobe catálogo torto, apaga tudo, simula pedido.
Nela existem duas rotas que não existem em produção: POST /sandbox/pedidos, que\nsimula um pedido e dispara o webhook (em produção, o pedido só nasce de um cliente\ncomprando), e POST /sandbox/limpar, para recomeçar do zero.
Quando um lojista contratar você, ele gera no painel dele uma credencial nvt_live_\nda loja real. Uma não vale no lugar da outra: chave de teste apontando para a loja\nque vende é recusada, e o contrário também. É o que impede o acidente de subir\ncatálogo de homologação em quem está vendendo.
Todas as chamadas levam o token no cabeçalho:
\nAuthorization: Bearer \nO token já diz de qual loja se trata — nenhuma rota pede o id da loja. Isso\ntambém significa que um token nunca alcança o catálogo ou os pedidos de outra loja.
\nCada token carrega escopos, e a rota recusa (403) o que estiver fora deles:
\nHá dois caminhos, e o segundo é o recomendado para quem tem sistema próprio:
\nPOST /itens, PATCH /itens/{id}, DELETE /itens/{id}. Bom para\nalterações pontuais feitas por uma tela.POST /itens/lote envia até 500 itens de uma vez,\nidentificados por referencia_externa (o código do item no seu sistema). O que não\nexiste é criado, o que existe é atualizado, e você nunca precisa guardar o id do\nNavitrine. É assim que uma carga de catálogo inteira roda todo dia sem virar 500\nchamadas.Para sincronizar só o que mudou, use atualizado_desde na listagem:
GET /itens?atualizado_desde=2026-08-21T03:00:00Z&perPage=100\nO cliente fecha o pedido na vitrine e ele fica disponível aqui. Você recebe de duas\nformas, que podem conviver:
\nGET /pedidos?desde=...) de tempos em tempos — simples e suficiente\npara a maioria.PUT /webhooks. Chega mais\nrápido e evita consulta em vão.Todo pedido tem numero (sequencial por loja, o que o lojista enxerga) além do id.
Configurado o endereço, o Navitrine envia POST com o evento no corpo e assina a\nrequisição:
X-Navitrine-Event: pedido.criado\nX-Navitrine-Delivery: 018f3c1e-...\nX-Navitrine-Signature: sha256=3a7bd3e2360a...\nA assinatura é o HMAC-SHA256 do corpo cru com o seu segredo. Compare com o que\nvocê calcular, em comparação de tempo constante — sem isso qualquer um pode fingir\nser o Navitrine.
\nResponda 2xx em até 10 segundos. Qualquer outra coisa (ou demora) vira nova\ntentativa: 1min, 5min, 30min, 2h e 6h depois. O mesmo evento pode chegar duas vezes —\nuse o X-Navitrine-Delivery para ignorar repetido.
As listagens devolvem sempre o mesmo envelope:
\n{ \"data\": [], \"page\": 1, \"perPage\": 50, \"total\": 137 }\npage começa em 1 e perPage vai até 200.
Em POST, mande Idempotency-Key com um valor único seu (um uuid serve). Repetindo a\nchamada com a mesma chave em até 24h, a resposta é a da primeira — é o que salva a\nintegração quando a conexão cai depois de o pedido já ter sido criado.
120 requisições por minuto por token, e POST /itens/lote conta como uma. Toda\nresposta traz RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset; ao estourar,\na resposta é 429 com Retry-After.
2026-08-21T14:32:00.000Z).\"49.90\") — converter para float antes de\nsomar é como se perde centavo.null, não como \"\".Toda falha responde com o mesmo corpo:
\n{\n \"statusCode\": 400,\n \"path\": \"/api/v1/itens\",\n \"timestamp\": \"2026-08-21T14:32:00.000Z\",\n \"message\": \"Categoria não pertence a esta loja\",\n \"errors\": { \"categoria_id\": [\"Categoria não encontrada\"] }\n}\nA message é em pt-BR e pode ser mostrada a quem opera o seu sistema. errors só\naparece quando a falha é de validação, com o motivo por campo.
Decida pelo statusCode, nunca pelo texto da message. O texto melhora com o\ntempo — a mensagem que você casar com uma expressão regular hoje muda amanhã sem\nque isso seja uma quebra de contrato.
Erro de rede ou 5xx num POST é o caso em que a Idempotency-Key paga sozinha o\ntrabalho de gerá-la: repetir com a mesma chave não cria nada duas vezes.
O que a API recusa com 400 antes de tocar no banco:
\nTexto é aparado nas pontas antes de medir, então espaço sobrando não derruba a\nchamada.
\nA versão está no caminho: /api/v1. Enquanto for v1, o que está documentado\naqui continua funcionando como está descrito.
/api/v2). Nunca trocamos o\ncomportamento de uma rota v1 por baixo de quem já a usa.v2, a v1 fica de pé por no mínimo 6 meses depois do\nanúncio, e avisamos por e-mail no endereço da conta de desenvolvedor.deprecated: true neste contrato antes de\nparar de existir, e continua sendo devolvido enquanto a versão viver.Estas mudanças não são consideradas quebra, e sua integração precisa aguentá-las:
\nforma_pagamento, situacao da entrega).\nTrate valor desconhecido com um caminho padrão, em vez de estourar.message e de errors. Melhoram sem aviso — case pelo statusCode.E o contrário, que é quebra e portanto só acontece numa versão nova: remover\ncampo, mudar tipo de campo, tornar obrigatório o que era opcional, mudar o\nsignificado de um código de status.
\nCampo desconhecido que você mandar no corpo é ignorado, não recusado — o que\nfacilita a vida de quem manda o mesmo objeto para vários destinos.
\nContact Support:\n Name: Suporte Navitrine
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"56898986","collectionId":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","publishedId":"2sBYArVss6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0138C6"},"publishDate":"2026-08-22T10:40:13.000Z"},"item":[{"name":"Conta","item":[{"name":"De qual loja é este token, e o que ele pode fazer.","id":"3b36da53-3c49-4398-91bb-38eaa0afd5f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.navitrine.app/api/v1/me","description":"Primeira chamada de qualquer integração: confirma que a credencial funciona e diz\ncom qual loja você está falando. Não consome escopo nenhum — qualquer token válido\nresponde.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}},"urlObject":{"path":["me"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[]}},"response":[{"id":"a96a6dd1-0aad-41ff-86cd-eafc686fe311","name":"Credencial válida.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerDe quem é o token e o que ele pode fazer.
\n","_postman_id":"934b40df-2a53-44f5-b7e7-63ac72308720","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Loja","item":[{"name":"Dados da loja na vitrine.","id":"df3c4898-dc5a-48ad-8100-12ceab718b45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.navitrine.app/api/v1/loja","description":"Como a loja aparece para o cliente: nome, endereço, contato e se está publicada.\npublicada: false significa que a vitrine não exibe a loja no momento — catálogo\nenviado continua guardado, mas ninguém o vê.
É o que decide se a vitrine mostra a loja como aberta agora. Cada faixa é um\nperíodo de um dia; um dia com almoço fechado tem duas faixas.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}},"urlObject":{"path":["loja","horarios"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[]}},"response":[{"id":"e5aaae6c-ccc1-412c-9483-816afdaaceb9","name":"Faixas de funcionamento.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerSubstituição total: o que você enviar passa a ser o horário da loja, e o que ficou\nde fora deixa de valer. Enviar lista vazia deixa a loja sem horário — ela aparece\ncomo fechada.
\n","urlObject":{"path":["loja","horarios"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[]}},"response":[{"id":"57ce563f-5b1f-4516-be0a-ac354aed80e1","name":"Horário atualizado.","originalRequest":{"method":"PUT","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerCadastro e horário de funcionamento da loja na vitrine.
\n","_postman_id":"ea9d6767-c2dc-4a99-884d-dc8e2327d092","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Catálogo","item":[{"name":"Seções do catálogo da loja.","id":"08e43721-80db-4d0d-bb3b-b2037abe0629","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.navitrine.app/api/v1/categorias","description":"As divisões que organizam o catálogo na vitrine (\"Bebidas\", \"Higiene\"). São da\nloja, e não as categorias do marketplace — estas o Navitrine administra.
\n","urlObject":{"path":["categorias"],"host":["https://api.navitrine.app/api/v1"],"query":[{"disabled":true,"description":{"content":"Página, começando em 1.
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"Itens por página (máximo 200).
\n","type":"text/plain"},"key":"perPage","value":"50"}],"variable":[]}},"response":[{"id":"13865688-ebc1-41e9-afe1-c2363c242cc7","name":"Seções da loja.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerEnvie só os campos que mudam; os ausentes ficam como estão.
\n","urlObject":{"path":["categorias",":id"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[{"id":"068fb439-a37c-4b41-9336-4c7ef574efcb","description":{"content":"(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"b818cfa2-dba5-4052-9490-1402eca4b743","name":"Seção atualizada.","originalRequest":{"method":"PATCH","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerOs itens da seção não são removidos: ficam sem seção e continuam na vitrine.
\n","urlObject":{"path":["categorias",":id"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[{"id":"c5906d6a-b845-4b3e-a567-2cb1b2685f23","description":{"content":"(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"50e5df86-8467-428f-aa8a-303fec76f47d","name":"Seção removida.","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerTraz todos os itens da loja, inclusive os indisponíveis — é o seu catálogo como\no Navitrine o guarda, não o recorte que o cliente vê.
\nPara sincronizar só o que mudou desde a última execução, use atualizado_desde.
Página, começando em 1.
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"Itens por página (máximo 200).
\n","type":"text/plain"},"key":"perPage","value":"50"},{"disabled":true,"description":{"content":"Só os itens desta seção.
\n","type":"text/plain"},"key":"categoria_id","value":"d645b9d6-7dd4-37a7-42f2-300e53657bed"},{"disabled":true,"description":{"content":"Filtra por disponibilidade.
\n","type":"text/plain"},"key":"disponivel","value":"true"},{"disabled":true,"description":{"content":"Só o que mudou a partir deste instante (inclusive).
\n","type":"text/plain"},"key":"atualizado_desde","value":"2026-08-21T03:00:00.000Z"},{"disabled":true,"description":{"content":"Busca pelo código do item no seu sistema.
\n","type":"text/plain"},"key":"referencia_externa","value":"string"}],"variable":[]}},"response":[{"id":"b4cfe07d-5890-4aa9-bcae-d7cd44f9e196","name":"Itens da loja.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerO plano da loja limita quantos itens ela pode ter. Estourado o limite, a resposta é\n403 com a mensagem do plano — o item não é criado.
\n","urlObject":{"path":["itens"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[]}},"response":[{"id":"bf8272b5-b19c-4fed-8e1a-aa059b57591a","name":"Item criado.","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerO jeito recomendado de manter o catálogo em dia quando ele vive no seu sistema.
\nCada item é casado pela referencia_externa (o código dele no seu sistema): o que\nnão existe é criado, o que existe é atualizado. Você não precisa guardar os ids do\nNavitrine em lugar nenhum.
O lote não é tudo ou nada: cada item é conferido e gravado por conta própria, e a\nresposta diz o que aconteceu com cada um. Um preço inválido numa linha não derruba as\noutras 499 — aquela linha volta com situacao: \"falha\" e o motivo, e o resto entra.
resultados vem na mesma ordem do que você enviou, então dá para conciliar linha\na linha sem casar pela referência. As remoções, quando houver, aparecem no fim.
Com remover_ausentes: true, os itens da loja que não vierem no lote são removidos —\nuse quando o envio for o catálogo inteiro, nunca num envio parcial. Item cuja\nlinha foi recusada não é removido: mandar torto e não mandar são coisas\ndiferentes, e só a segunda justifica sumir com ele da vitrine.
O corpo inteiro só é recusado (400) quando nem o envelope se sustenta: itens\nausente, vazio ou com mais de 500 linhas.
(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"6f185177-fe53-4290-b694-2068763e0f5f","name":"Item.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerEnvie só o que muda. Para tirar o item da vitrine sem apagá-lo — o caso de \"acabou\no estoque\" — mande disponivel: false.
(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"4c8ec8d2-23f7-4857-b8fd-343f6615c0c2","name":"Item atualizado.","originalRequest":{"method":"PATCH","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerSome da vitrine na hora. Pedidos antigos que citam o item continuam intactos.
\n","urlObject":{"path":["itens",":id"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[{"id":"06fae872-12dc-45fc-973d-d86b093dce2d","description":{"content":"(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"d3d2398e-5e08-49e3-8771-cdab8ed5674c","name":"Item removido.","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerSeções e itens — o que a vitrine mostra ao cliente.
\n","_postman_id":"774ca03c-6303-443b-979d-c763a27099f9","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Pedidos","item":[{"name":"Pedidos recebidos pela loja.","id":"da8cb8d4-248f-4e8b-8897-59345569af03","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.navitrine.app/api/v1/pedidos","description":"Do mais recente para o mais antigo. Para buscar só o que chegou depois da última\nconsulta, use desde com o instante da execução anterior.
Quem prefere não consultar de tempos em tempos pode configurar um webhook e receber\ncada pedido assim que ele acontece.
\n","urlObject":{"path":["pedidos"],"host":["https://api.navitrine.app/api/v1"],"query":[{"disabled":true,"description":{"content":"Página, começando em 1.
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"Itens por página (máximo 200).
\n","type":"text/plain"},"key":"perPage","value":"50"},{"disabled":true,"description":{"content":"Só pedidos criados a partir deste instante (inclusive).
\n","type":"text/plain"},"key":"desde","value":"2026-08-21T03:00:00.000Z"},{"disabled":true,"description":{"content":"Só pedidos criados até este instante.
\n","type":"text/plain"},"key":"ate","value":"2014-07-30T05:56:31.793Z"}],"variable":[]}},"response":[{"id":"2d70a767-57ef-492e-963f-3ed12fa72b76","name":"Pedidos da loja.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerO mesmo pedido que chega pelo webhook, útil para reprocessar um evento perdido.
\n","urlObject":{"path":["pedidos",":id"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[{"id":"80a15f19-1913-481d-a56e-8d6ad0b6e5f7","description":{"content":"(Required) Identificador no Navitrine (uuid).
\n","type":"text/plain"},"type":"any","value":"9f1c2e7a-5b3d-4c8e-9a2f-1d6b7c4e8a30","key":"id"}]}},"response":[{"id":"be141351-ed12-40c4-b355-4028fe477d83","name":"Pedido.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerPedidos feitos na vitrine, prontos para entrar no seu sistema.
\n","_postman_id":"721be624-addb-43bb-a38f-f080f4c5cca2","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Webhooks","item":[{"name":"Para onde os eventos estão sendo enviados.","id":"db5c0b02-5441-48a3-b023-5737ff4cc0fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.navitrine.app/api/v1/webhooks","description":"Devolve null quando não há webhook configurado. O segredo nunca volta inteiro —\nsó os últimos caracteres, para conferir qual está em uso.
O endereço precisa ser https. Guarde o segredo da resposta: ele aparece uma\núnica vez e é com ele que você confere a assinatura de cada entrega.
Enviar ativo: false pausa os envios sem perder a configuração.
Serve para investigar o que chegou — ou por que não chegou — sem depender de nós\nolharmos o banco. Traz a situação de cada entrega, quantas tentativas houve, o\nstatus que o seu endereço devolveu e o erro registrado.
\nSem webhook configurado, devolve lista vazia.
\n","urlObject":{"path":["webhooks","entregas"],"host":["https://api.navitrine.app/api/v1"],"query":[{"disabled":true,"description":{"content":"Página, começando em 1.
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"Itens por página (máximo 200).
\n","type":"text/plain"},"key":"perPage","value":"50"}],"variable":[]}},"response":[{"id":"d48f92fe-b54c-476f-8f09-b3f07209cbe8","name":"Entregas do seu webhook.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerEnvia um pedido.criado de mentira, com dados fictícios, e devolve o que o seu\nendereço respondeu — status, tempo e o começo do corpo. Serve para validar a\nassinatura e o parsing antes de o primeiro pedido real chegar.
Para onde o Navitrine avisa quando algo acontece.
\n","_postman_id":"4d4ff52c-6686-40ae-82ae-6a08a2a72806","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Desenvolvedor","item":[{"name":"Cria uma conta de desenvolvedor com loja de testes.","id":"26a0ebdb-ad5c-44cf-9b95-f3a49082cdd6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"nome\": \"ERP da Silva\",\n \"email\": \"dev@erpdasilva.com.br\",\n \"password\": \"uma-senha-boa-2026\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.navitrine.app/api/v1/dev/registrar","description":"O começo de tudo para quem vai integrar: você sai daqui com uma credencial\nnvt_test_ na mão e pode chamar a API na mesma sessão, sem falar com ninguém e\nsem precisar de um lojista.
A loja criada é uma sandbox: não aparece na vitrine, não é cobrada e não dispara\nmensagem para lojista nenhum. Ela já vem com duas seções de exemplo, para o\nprimeiro POST /itens/lote ter onde cair.
A credencial só aparece nesta resposta. O login criado serve para gerar outra\ndepois, pelo painel.
\nEsta é a única rota da API que não pede autenticação — e tem teto próprio de\ncadastros por hora.
\n","urlObject":{"path":["dev","registrar"],"host":["https://api.navitrine.app/api/v1"],"query":[],"variable":[]}},"response":[{"id":"8f25b726-725b-4f9b-89b2-20117d7d1fbc","name":"Conta criada. Guarde a credencial — ela não volta.","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"BearerCadastro auto-serviço de quem vai integrar. Única rota da API que não pede\ncredencial.
\n","_postman_id":"8d30710d-e5cf-4f6b-b951-79d564075f05","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","id":"f25a7e0d-6789-428b-a83e-b22a7b151a2b","name":"API do Navitrine","type":"collection"}}},{"name":"Loja de testes","item":[{"name":"Cria um pedido de mentira na loja de teste.","id":"d92b4a99-01e0-4cee-9c87-105fc2eca820","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cliente_nome\": \"Maria Souza (teste)\",\n \"itens\": [\n {\n \"referencia_externa\": \"SKU-4471\",\n \"quantidade\": 2\n }\n ],\n \"forma_pagamento\": \"PIX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.navitrine.app/api/v1/sandbox/pedidos","description":"Em produção o pedido nasce no app do cliente — sem esta rota, testar a integração\nde pedidos exigiria abrir a vitrine e fechar um carrinho a cada tentativa.
\nEla cria o pedido e dispara o pedido.criado no seu webhook, com o mesmo formato\nda produção: é o caminho para validar assinatura e parsing antes do primeiro\npedido real. Os itens são informados pela referencia_externa que você acabou de\nenviar na carga.
Só funciona com credencial nvt_test_; em loja que vende, responde 403. E\nnenhuma mensagem sai para o lojista — loja de teste não dispara WhatsApp.
Deixa a loja de teste como nova, para você repetir a carga do zero quantas vezes\nquiser — refazer o teste é o uso normal de quem integra, não a exceção.
\nSó funciona com credencial nvt_test_.
Ferramentas que só existem na loja de testes: simular pedido e limpar o que você\ncriou. Exigem credencial nvt_test_.