Baixa do Pedido
Com a API da Fbits o lojista consegue baixar todos pedidos quantas vezes forem necessárias, no retorno do mesmo é no formato json que facilita o mapeamento com o ERP do cliente.
Para capturar os pedidos o sistema que irá se conectar a API deverá enviar alguns dados obrigatórios além da chave de acesso, esses dados são: dataInicial e dataFinal (os dois deverão estar no formato ano-mês dia “aaaa-mm-dd”), além desses existem alguns campos opcionais que ajudam a filtrar a lista de pedido, são eles: enumTipoFiltroData (por qual data se deseja ordenar o retorno dos pedidos – padrão “dataPedido”), situacoesPedido (lista das situações que se deseja), formasPagamento (lista das formas de pagamento que se deseja), pagina (para não vir todos os pedidos a API retorna os pedidos paginados, com isso os retornos das requisições ficarão mais rápidos – padrão 1) e quantidadeRegistros (essa opção é para dizer quantos pedidos deverão ser retornados em cada página – padrão 50). Após fazer a requisição a API retornará a lista de pedidos conforme filtrado, um detalhe importante é que a lista de pedidos sempre é retornada na ordem decrescente pelo campo enumTipoFiltroData e isso influência diretamente na lista de retorno.
A API também conta com alguns métodos de GET de baixa pedidos auxiliares, são eles “pedidos/situacaoPedido” e “pedidos/formaPagamento” esses métodos permitem que o lojista faça consultas mais específicas facilitando a criação de suas regras.
Exemplos de requisições “Get/Pedidos” utilizando “Curl”:
- Todos os pedidos em um range de datas:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic token-da-loja' 'https://api.fbits.net/pedidos?dataInicial=2017-06-01&dataFinal=2017-06-06'
- Todos os pedidos em um range de datas e somente boleto:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic token-da-loja' 'https://api.fbits.net/pedidos?dataInicial=2017-06-01&dataFinal=2017-06-06&formasPagamento=1'
- Todos os pedidos em um range de datas, com forma de pagamento visa e master, e que estejam com a situação pago:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic token-da-loja' 'https://api.fbits.net/pedidos?dataInicial=2017-06-01&dataFinal=2017-06-06&situacoesPedido=1&formasPagamento=3%2C%204'
- Todos os pedidos em um range de datas, com forma de pagamento visa e master, que estejam com a situação pago, e ordenado pela data de aprovação de pagamento:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic token-da-loja' 'https://api.fbits.net/pedidos?dataInicial=2017-06-01&dataFinal=2017-06-06&enumTipoFiltroData=DataAprovacao&situacoesPedido=1&formasPagamento=3%2C%204'
Exemplos de requisições “Get/Pedidos/situacaoPedido” utilizando “Curl”:
- Todos os pedidos em um range de datas, com a situação pago e aguardando pagamento das formas de pagamento boleto e visa:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic token-da-loja' 'https://api.fbits.net/pedidos/situacaoPedido/1%2C%208?dataInicial=2015-06-01&dataFinal=2017-06-06&formasPagamento=1%2C2'
Exemplos de requisições “Get/Pedidos/formaPagamento” utilizando “Curl”:
- Todos os pedidos em um range de datas, com as formas de pagamento boleto e visa com as situações pago e cancelado:
- curl -X GET --header 'Accept: application/json' --header 'Authorization: Basic bbac7878-b1d1-4e95-95ab-1cb63567aa97' 'https://api.fbits.net/pedidos/formaPagamento/1%2C2?dataInicial=2015-06-01&dataFinal=2017-06-06&situacoesPedido=1%2C%208'
Com bases nesses exemplos o cliente pode desenvolver outras regras que atendam suas necessidades.