Documentação da API — pedidoeletronico.com

Sobre esta API

Referência dos endpoints REST da plataforma. Todas as requisições usam a URL base https://apidata.pedidoeletronico.com/ e exigem o header de autenticação xToken (exceto onde indicado). Clique em um endpoint para ver parâmetros e exemplos. Prefere um explorador interativo? Use a documentação Swagger.

Limites de requisição e boas práticas

Recomendações para consumir a API com estabilidade. Os limites abaixo se aplicam a todos os métodos — envio de pedidos, consultas de clientes e de históricos.

Métodos mais usados

Método	Uso	Recomendação
`POST api/PedidoVenda/Post`	Enviar / atualizar pedido	Um pedido por requisição; em lote, serialize e use backoff
`GET api/Cliente/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}`	Listar clientes	Pagine e sincronize por `dtUltimaAlteracao`
`GET api/PedidoVenda/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}`	Histórico de pedidos	Pagine; baixe só o que mudou desde a última sincronização
`GET api/StatusVenda/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}`	Histórico de status	Pagine; baixe só o que mudou desde a última sincronização

Boas práticas

Autenticação. Envie o header xToken em toda requisição e nunca exponha o token no cliente.
Ritmo. Mantenha até 300 requisições por minuto por token e poucas requisições simultâneas. Use fila, não rajada.
Backoff. Ao receber erros 5xx ou 429, aguarde e repita com backoff exponencial (1s, 2s, 4s…).
Sincronização incremental. Envie dtUltimaAlteracao e baixe apenas o que mudou, em vez de varrer toda a base.
Paginação. Percorra as listagens por página ({pagina} / {quantidadeRegistros}) até receber uma lista vazia.
Payload enxuto. Mantenha o corpo abaixo de 15 MB; para grandes volumes, quebre em lotes menores.
Reúso de conexão. Habilite keep-alive e reaproveite a conexão HTTP; evite abrir uma conexão nova a cada chamada.
Cache local. Guarde dados que mudam pouco (tabelas de preço, cadastros) e evite rebuscar a cada tela.

Atenção: requisições acima de 15 MB são rejeitadas pelo servidor. Chamadas em rajada podem sobrecarregar a infraestrutura compartilhada e ser bloqueadas — integrações que seguem as boas práticas acima não são afetadas.

CategoriaProduto (3 endpoints)

API	Description
GET api/CategoriaProduto/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/CategoriaProduto/ObterRegistro/{id}	Sem documentação.
POST api/CategoriaProduto/Post	Sem documentação.

Equipes (1 endpoint)

API	Description
GET api/Equipes/ObterRegistros	Sem documentação.

MovimentacaoEstoque (3 endpoints)

API	Description
GET api/Estoque/ObterRegistro/{id}	Sem documentação.
POST api/Estoque/Post	Sem documentação.
POST api/Estoque/Excluir/{id}	Sem documentação.

CondicaoPagamento (3 endpoints)

API	Description
GET api/CondicaoPagamento/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/CondicaoPagamento/ObterRegistro/{id}	Sem documentação.
POST api/CondicaoPagamento/Post	Sem documentação.

PedidoVenda (9 endpoints)

API	Description
GET api/PedidoVenda/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/PedidoVenda/ObterRegistrosPorEmissao/{pagina}/{quantidadeRegistros}/{dtEmissao}	Sem documentação.
GET api/PedidoVenda/PesquisarRegistro	Sem documentação.
GET api/PedidoVenda/ObterRegistro/{id}	Sem documentação.
GET api/PedidoVenda/ObterHistoricoStatus/{id}	Sem documentação.
GET api/PedidoVenda/ObterHistoricoStatusPorMeuID/{xMeuID}	Sem documentação.
POST api/PedidoVenda/Post	Sem documentação.
POST api/PedidoVenda/Excluir	Sem documentação.
POST api/PedidoVenda/atualizarstatus	Sem documentação.

Empresa (1 endpoint)

API	Description
GET api/Empresa/ObterRegistro	Sem documentação.

Imagem (2 endpoints)

API	Description
GET api/Imagem/ObterRegistros/{idProduto}/{dtUltimaAlteracao}	Sem documentação.
POST api/Imagem/Post	Sem documentação.

Contato (4 endpoints)

API	Description
GET api/Contato/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Contato/ObterRegistrosPorIdCliente/{idCliente}/{pagina}/{quantidadeRegistros}	Sem documentação.
GET api/Contato/ObterRegistro/{idContato}	Sem documentação.
POST api/Contato/Salvar	Sem documentação.

Transportadora (3 endpoints)

API	Description
GET api/Transportadora/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Transportadora/ObterRegistro/{id}	Sem documentação.
POST api/Transportadora/Post	Sem documentação.

Produto (3 endpoints)

API	Description
GET api/Produto/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Produto/ObterRegistro/{id}	Sem documentação.
POST api/Produto/Post	Sem documentação.

Representacao (3 endpoints)

API	Description
GET api/Representacao/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Representacao/ObterRegistro/{id}	Sem documentação.
POST api/Representacao/Post	Sem documentação.

StatusVenda (3 endpoints)

API	Description
GET api/StatusVenda/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/StatusVenda/ObterRegistro/{id}	Sem documentação.
POST api/StatusVenda/Post	Sem documentação.

Endereco (4 endpoints)

API	Description
GET api/Endereco/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Endereco/ObterRegistrosPorIdCliente/{idCliente}/{pagina}/{quantidadeRegistros}	Sem documentação.
GET api/Endereco/ObterRegistroPorIdEndereco/{idEndereco}	Sem documentação.
POST api/Endereco/Salvar	Sem documentação.

TabelaPreco (3 endpoints)

API	Description
GET api/TabelaPreco/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/TabelaPreco/ObterRegistro/{id}	Sem documentação.
POST api/TabelaPreco/Post	Sem documentação.

RecebimentoTitulosMovimentacao (1 endpoint)

API	Description
GET api/RecebimentoTitulosMovimentacao/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.

RecebimentoTitulos (1 endpoint)

API	Description
GET api/RecebimentoTitulos/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.

Clientes (4 endpoints)

API	Description
GET api/Cliente/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Cliente/PesquisarRegistro	Sem documentação.
GET api/Cliente/ObterRegistro/{id}	Sem documentação.
POST api/Cliente/Post	Sem documentação.

UnidadeMedida (3 endpoints)

API	Description
GET api/UnidadeMedida/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/UnidadeMedida/ObterRegistro/{id}	Sem documentação.
POST api/UnidadeMedida/Post	Sem documentação.

RamoAtividade (3 endpoints)

API	Description
GET api/RamoAtividade/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/RamoAtividade/ObterRegistro/{id}	Sem documentação.
POST api/RamoAtividade/Post	Sem documentação.

Representantes (3 endpoints)

API	Description
GET api/Representantes/ObterRegistros/{pagina}/{quantidadeRegistros}/{dtUltimaAlteracao}	Sem documentação.
GET api/Representantes/ObterRegistro/{id}	Sem documentação.
POST api/Representantes/Post	Sem documentação.