Caraterísticas dos pedidos
Nas seguintes páginas são exemplificados alguns dos pedidos mais comuns à API. Estes estão subdivididos em diferentes áreas.
Pré-requisitos para a realização de qualquer um dos pedidos:
Um acesso autenticado à empresa de trabalho, via OAuth (o modo de autenticação está documentado na página anterior
A empresa de trabalho deverá ter uma licença de GC activa, excepto para os GET, que serão autorizados mesmo quando a licença expira
Conteúdos dos Headers, comuns a todos os pedidos
Content-Type: application/vnd.api+json
Accept: application/json
Authorization: Bearer <access_token> (token de acesso válido devolvido pelo serviço de OAuth)
Filtro de parâmetros:
De momento não estão disponíveis rotas que cubram todo o tipo de informação que está disponível através do software. No entanto, muitos recursos que não têm uma rota dedicada podem ser acedidos por outras rotas, utilizando os filtros de parâmetros.
Por exemplo, apesar de não existir nenhuma rota para documentos de venda pendentes, existe uma rota de documentos de venda. Estes documentos contém um atributo de valor pendente.
Como tal, é possível obter apenas os documentos com valor pendente, da seguinte forma:
GET
commercial_sales_documents
Path Parameters
De notar que deverá indicar o tipo de documento no atributo que procura filtrar. Neste caso, deverá ser documents.pending_total.
commercial_sales_documents -> documents
commercial_sales_receipts -> receipts
commercial_purchases_documents -> purchases_documents
commercial_purchases_payments -> payments
Da mesma forma, poderá filtrar, por exemplo, pela data.
GET
commercial_sales_document_lines
Path Parameters
Deverá também indicar o tipo de linhas de documento pelo qual está a filtrar, tal como na lista acima. De seguida está um exemplo de como poderá realizar um pedido utilizando este filtro
É recomendável utilizar paginação, caso haja um grande número de resultados para ser apresentado
Last updated