omiexperience / api-examples Goto Github PK

Projetos de exemplo para consumo da API

Pascal 35.62% PHP 18.23% C# 43.03% JavaScript 1.17% HTML 0.87% TypeScript 1.08%

api-examples's Introduction

Começando a integração com Omie

Agora vai! Seja bem vindo ao nosso repositório com mais informações para os nerds, geeks e entusiastas :-)

Portal do desenvolvedor

O Portal do desenvolvedor é a nossa nave mãe, lá você encontrará a lista de todas as API's, exemplos de uso, credenciais de acesso, etc:

http://developer.omie.com.br/

Credencias de autenticação

Para obter as credenciais de acesso siga esse guia:

http://docs.omie.com.br/m/20204/l/612759-obtendo-a-chave-de-acesso-para-integracoes-de-api

Por boa prática, não começa os testes no aplicativo de produção :-)

Eu sei que é mais forte que você, mas recomendamos do fundo do coração que você crie um aplicativo novo para realizar os testes (pode ficar tranquilo, é grátis)

Lista de API's

Não queremos ser repetitivos, mas para facilitar a sua vida vamos deixar um link para a lista de API's e exemplos de uso:

http://developer.omie.com.br/service-list/

SDK's e Exemplos

Como testar as API's

Você pode começar os testes usando os exemplos que deixamos prontos. Por exemplo, se acessarmos a API de Contas Correntes, será possível, consultar todos os métodos e a documentação dos campos disponíveis. A grande maioria das APIs dispõe de um método para listar os registros cadastrados. Para começar, podemos testar o método PesquisarContaCorrente.

Na própria documentação, você encontra uma forma de testar a API sem que haja necessidade de realizar nenhuma implementação. Basta clicar no botão "Teste agora mesmo":

Ao clicar no botão “Teste agora mesmo” a ferramenta de teste é exibida e já está pronta para que você experimente. Basta clicar no botão “Executar”. Nesse momento, você não precisa se preocupar com o APP_KEY e o APP_SECRET que já estão informados na tela. Eles se referem a um aplicativo de testes da Omie e você pode utilizar para consultar e verificar os resultados da requisição. Mas, se preferir, você pode substituir essas informações pela APP_KEY e APP_SECRET do seu aplicativo de testes.

Você também irá notar que pode trocar o método da requisição alterando o valor do campo OMIE_CALL. Caso você altere o método é importante verificar também o conteúdo da requisição, que varia de acordo com a requisição.

O resultado da requisição será algo semelhante ao que podemos observar abaixo:

Mais ajuda

Esse quick start foi baseado num PDF criado por um dos nossos especialistas. Se você quer saber mais detalhes de como criar um aplicativo teste, como configurar o SoapUI ou Postman para realizar os testes, dá uma olhada nele:

Omie API - Quick Start [By Darth Vader].pdf

Caso você tenha alguma dúvida sobre o uso API ou se o teste que você está realizando não está retornando o que você esperava, você pode compartilhar a requisição clicando em “Compartilhar esse exemplo”.

Ao clicar, você verá o link do compartilhamento desse exemplo. Encaminhe esse link que para termos acesso ao mesmo teste que você está realizando: [email protected] :-)

Se você está começando o seu projeto agora, também pode ajudar um bate papo com nossos especialistas para debater a melhor forma de montar a integração :-)

api-examples's People

Contributors

Stargazers

Watchers

Forkers

diegolsr equintino pereiraclaudemir josesaribeiro naldocarvalho rc-inovatech ytalokaio flavioribs danillocaetano matheusrcruz12 dulemos crescersci guiireal mmnunesmsn bessa3301 iepsenn ov4ts einsteinbraga mauroprojetos pedrobonatti mrgobbo felipeduarteferreira gabrieltibom pedropbazzo cleisonvieira-gliart helcionv sidneisimeao devdiogenes scevangelista samuelcapucho miottodmie camillanapoles alanmartines gutonovaes19 rafafrassetto

api-examples's Issues

Can't UpsertProduto

input

{
  codigo_produto_integracao: 162,
  codigo: 'BOG-FRU1-CAT2-91:128:302:304',
  codigo_produto: 162,
  descricao: 'Cebolla Cabezona Roja Cero Limpia',
  unidade: 'KG',
  valor_unitario: 2300,
  ncm: '1571319712'
}

error

error: omie error  {"faultstring":"ERROR: Preencha apenas a tag [codigo_produto] ou a tag [codigo_produto_integracao] ou a tag [codigo]!","faultcode":"SOAP-ENV:Client-103"}

why this error happening? i work with this the last 3 weeks and this error didn't happen to me before

Consulta de produto por código

Olá,
estou tentando realizar uma consulta utilizando o código.
Preciso obter na resposta o CMC Unitário do item.

Qual seria o Endpoint e OMIE_CALL que preciso consultar?
Não consegui encontrar na documentação.

Anexo a imagem para ilustrar melhor as informações de input e output que estou buscando.

Obrigado.

Link aponta para a página errada

O link para o exemplo PHP aponta para o exemplo dotnet

Não consigo fazer o processo 'IncluirOrdemProducao'

https://app.omie.com.br/api/v1/produtos/op/#IncluirOrdemProducao

Alguém sabe como faz para Incluir ordem em produção, tentei usar os parâmetros indicados no link em cima, mas retorna que não foi encontrado a tag, poderiam me auxiliar ou dar um exemplo.

Não consegui

Tentei usar o código do vb6 aqui e não consegui. Pode me ajudar?

Status do Cliente

Existe algum método na API que eu consiga puxar a situação do cliente em relação ao financeiro? (Ex: Adimplente, Inadimplente, etc)?

CURL - Endpoint Incluir Anexo Arquivo

Ao tentar efetuar o post através de Curl enviando o json como file está dando a mensagem:

{"status":"error","message":"Invalid JSON object"}

Comando:
curl https://app.omie.com.br/api/v1/geral/anexo/ -H "Content-type: application/json" -d @envio.json

Obs: O mesmo arquivo json funciona corretamente via Postman. (Contém um pdf zipado, base64 e seu hash md5)
envio.zip

Não achei exemplo em PHP

Ola estou usando PHP 5.6 em Servidor Linux,

Temos algum exemplo em PHP pois nosso Sistema ERP esta em plataforma Cloud.

Consultar contas a receber em atraso

Existe alguma API que eu possa consultar para saber quais as contas a receber estão em atraso ?

Obrigado

Conectar via Webhook

Olá pessoal,

Gostaria de solicitar um webhook do lado do Omie, isso iria ajudar muito aos apps que fazem requisição no Omie e também seria melhor para o próprio servidor de vocês, pois iria diminuir o número de chamadas.

Por exemplo:

No meu cenário, criamos uma rotina para constantemente ficar fazendo chamadas ao Omie, e verificando se teve atualização nas Ordens de Serviço. Porém isso não é a melhor forma de fazer, e recentemente estamos recebendo muitos erros, como esse:

SOAP-ENV:Client-8020 - ERROR: Esta requisição já foi processada ou está sendo processada e você pode tentar novamente às 10:06:26. (1) - Em 12/11/2020 10:05

Isso gera muitos problemas, pois temos que tentar novamente as chamadas depois de um tempo, aumentando o número de requisições no servidor de vocês.

Esse tipo de coisa se resolveria com um webhook, onde no caso ficaria esperando alguma alteração na Ordem de Serviço.

Acredito que é uma mudança pra ambas as partes, este é meu feedback.