Antes que possa começar de fato os testes com a nossa API, é importante que conheça alguns processos básicos:
💡 #DicaDoBem: Atualmente, conseguimos testar as nossas API’s diretamente pelo site do Developer, porém, existem alguns programas que também podem realizar esse processo, como é o caso do Postman, Insomnia e o ThunderClient (uma extensão do VS Code) |
Para o nosso teste, vamos utilizar diretamente o Developer. Assim como, vamos utilizar o APP KEY e o APP SECRET padrões, mas se preferir, pode alterar para o seu 😉
Para criar o produto, temos que seguir o mínimo de requisitos obrigatórios, igual tem no sistema:
As informações mínimas obrigatórias, que devem ter na nossa requisição então são: Descrição do produto, Código do Produto, Unidade e Código NCM
Então, vamos criar a seguinte requisição, por meio do método abaixo:
{
"codigo_produto_integracao": "789456132",
"codigo": "API/XXXX1",
"descricao": "Produto API - XXXX1",
"unidade": "UN",
"ncm":"0000.00.00",
"descr_detalhada": "Produto criado exclusivamente por API",
"obs_internas": "Aqui podemos preencher qualquer observação que desejarmos sobre o produto"
}
Toda vez que formos inserir uma informação dentro de uma requisição, devemos obrigatoriamente enviar com aspas duplas. Sempre que aparecer “código_(nome)_integração”, é o código do produto (no nosso caso) usado especificamente para integrações entre sistemas, ele não vai aparecer no sistema
Observe que foram adicionadas duas informações opcionais: descrição detalhada e as observações internas do produto. Elas são informações que eu posso adicionar na minha requisição, pois fazem parte do escopo dela. E posso conferir quais outras mais fazem por aqui:
Vamos, agora, executar a nossa requisição criada:
Observe que ele tornou com sucesso a seguinte mensagem:
{
"codigo_produto": 5366578297,
"codigo_produto_integracao": "789456132",
"codigo_status": "0",
"descricao_status": "Produto cadastrado com sucesso!"
}Essa tag retornada “código_produto” é muito importante, pois, é com ela que vamos consultar e fazer operações com nosso produto via API
E aqui está o nosso produto no sistema, com as informações que preenchemos:
Prontinho 😊
📌 Separamos alguns artigos interessantes para você
