Em uma negociação, nem toda venda cabe em um padrão fixo. Cada cliente é único e cada acordo exige uma flexibilidade diferente.
Pensando nisso, o Omie traz uma funcionalidade que é a cara da flexibilidade: nesse passo a passo você poderá criar suas próprias opções de parcelamento, além das que já vêm prontas no sistema. Prático e fácil, né? 🚀
⚠️ Importante
Cadastre uma única vez por aplicativo: um novo Número de Parcela só precisa ser cadastrado uma vez no ERP. Então, ele estará disponível em todos os módulos do Omie com esse recurso.
Número de Parcelas por aplicativo: cada aplicativo Omie possui sua própria tabela de parcelas, então, o seu cadastro é individual por aplicativo.
Informações Importantes sobre as APIs Omie
Antes de iniciar seus testes com a nossa API, é fundamental conhecer alguns processos básicos:
✅ Acessando a documentação: consulte nossa documentação oficial para entender os endpoints disponíveis e seus respectivos parâmetros;
🔑 Chaves de Integração da API: saiba como obter e utilizar suas credenciais de acesso para autenticar as requisições;
⚙️ Características e Recomendações: fique por dentro das melhores práticas para otimizar sua experiência com a API da Omie;
🔐 Login no Portal: para testar suas requisições no Portal do Desenvolvedor é necessário fazer login na plataforma com o mesmo e-mail e senha que você já usa no ERP. Fácil, né? 😉
🧪 Aplicativo Teste: aprenda a criar um Aplicativo Teste gratuito e descubra, na prática, como utilizar nossas APIs e aproveitar ao máximo os nossos recursos.
💡 Dica
Você pode testar nossas APIs diretamente no nosso Portal do Desenvolvedor. Além disso, ferramentas como Postman, Insomnia e ThunderClient (extensão do VS Code) também são ótimas opções para realizar testes.
Cadastrando um novo Número de Parcelas via API
1) Antes de realizar os testes na API, realize o login de acesso no Omie:
2) No Portal do Desenvolvedor, acesse a lista de APIs:
3) No tópico "Geral", selecione a opção Parcelas:
4) Para incluir um novo Número de Parcela, é preciso utilizar o método IncluirParcela:
5) Após selecionar o método "IncluirParcela", você verá os parâmetros disponíveis (1) e a ferramenta para teste rápido na opção "Teste agora mesmo" (2):
6) Você será direcionado para a tela de testes do Developer, onde poderá configurar e enviar requisições para a API. Veja como cada campo funciona:
(1) Endpoint. Esse campo o Omie preencherá automaticamente este campo com;
(2) Aplicativo ou Chave de Acesso. Aqui, você verá uma lista dos aplicativos aos quais seu e-mail tem acesso. Basta selecionar o desejado, e os campos App Key e App Secret serão preenchidos automaticamente.
📣 Lembrete
Caso precise testar um aplicativo que não aparece na lista, selecione "O aplicativo que eu quero não está na lista" e insira manualmente suas credenciais.
(3) Call. Este campo o Omie definirá automaticamente o tipo de chamada como IncluirParcela;
(4) Conteúdo. Este é o campo onde você configurará sua requisição, inserindo os dados necessários para incluir seu Número de Parcela.
7) A seguir, demonstramos um exemplo de requisição para a inclusão de um novo Número de Parcela:
{
"cParcela": "22/33/45"
}
⚠️ Importante
Atualmente, ao cadastrar um Número de Parcelas, há quatro tipos de formatações aceitas. Você pode seguir os seguintes exemplos:
10/20/30/40. Com este tipo de formatação, o sistema entenderá que deve cadastrar 4 Parcelas. Sendo a primeira para 10 dias, a segunda para 20 dias e, assim, sucessivamente;
A Vista/40/60. Nesta formatação, será cadastrada para 3 Parcelas. Sendo a primeira a vista, a segunda para 40 dias e, a terceira, para 60 dias;
Para 93 dias. Com esse preenchimento, será cadastrada uma Parcela para 93 dias após o faturamento;
50. Ao indicar um número único, o sistema entenderá que se trata da quantidade total de Parcelas. Neste caso, será cadastrado 50 Parcelas.
8) Ao executar a requisição com todos os parâmetros corretamente informados, você receberá uma resposta positiva contendo o código do Número de Parcela.
Esse identificador, retornado na tag “cCodParcela”, é fundamental, por servir como referência para a realização de operações via API:
9) Tudo pronto! No Omie ERP, o Número de Parcela estará cadastrado para todos os módulos:
