Introdução
Migrar da v1
Autenticação
Resposta e erros
SDKs e plugins
Países
Isenções IVA
Changelog
Vendas
Recibos
Clientes
Artigos
Administração - Armazéns
Administração - Categorias
Administração - Colaboradores
Administração - Condições de pagamento
Administração - Formas de pagamento
Administração - Locais
Administração - Modos de expedição
Administração - Moedas
Administração - Tabela de preços
Administração - Séries
Administração - Taxas de IVA
Administração - Veículos
Administração - Unidades
Vendas - Procurar
—
Permite procurar por uma venda no estado Terminado
ou Cancelado
.
value
mixed
required
Valor a procurar
search_in
string
required
Determina em que campo deve ser procurado. Deve ser enviado um dos seguintes valores: ID
, Document Number
. No caso da procura ser efectuada no nº do documento, a seguinte nomenclatura exemplo deve ser enviada: FT A/4921
.
URL
https://facturalusa.pt/api/v2/sales/find
Método
post
Resposta
200
Resposta exemplo
{
"id": null,
"sale_reference_id": null,
"number": null,
"issue_date": null,
"due_date": null,
"serie_id": null,
"document_type_id": null,
"document_full_number": null,
"gross_total": "0.00",
"total_discount": "0.00",
"net_total": "0.00",
"total_base_vat": "0.00",
"total_vat": "0.00",
"total_shipping": "0.00",
"grand_total": "0.00",
"grand_total_with_currency_exchange": "0.00",
"final_discount_financial": "0.00",
"final_discount_global": "0.00",
"final_discount_global_value": "0.00",
"customer_id": null,
"customer_code": null,
"customer_name": null,
"customer_vat_number": null,
"customer_country": null,
"customer_city": null,
"customer_address": null,
"customer_postal_code": null,
"customer_delivery_address_country": null,
"customer_delivery_address_address": null,
"customer_delivery_address_city": null,
"customer_delivery_address_postal_code": null,
"company_name": null,
"company_vat_number": null,
"company_country": null,
"company_address": null,
"company_city": null,
"company_postal_code": null,
"payment_method_id": null,
"payment_condition_id": null,
"shipping_mode_id": null,
"shipping_value": "0.00",
"shipping_vat_id": null,
"price_id": null,
"currency_id": null,
"currency_exchange": "0.00000",
"vat_type": null,
"observations": null,
"irs_retention_apply": "0.00",
"irs_retention_base": "0.00",
"irs_retention_total": "0.00",
"irs_retention_tax": "0.00",
"url_file": null,
"file_previewed": null,
"file_language": null,
"file_format": null,
"email_sent": null,
"sms_sent": null,
"status": null,
"vehicle_id": null,
"employee_id": null,
"waybill_shipping_date": null,
"waybill_global": null,
"at_code": null,
"at_message": null,
"at_success": null,
"mb_entity": null,
"mb_sub_entity": null,
"mb_reference": null,
"cargo_location": null,
"discharge_location": null,
"cargo_date": null,
"discharge_date": null,
"signed": null,
"signed_id": null,
"sign_attempt": null,
"sign_error": null,
"created_by": null,
"finished_by": null,
"finished_at": null,
"canceled_by": null,
"canceled_at": null,
"canceled_reason": null,
"updated_at": null,
"created_at": null,
"reference": null,
"serie": null,
"documenttype": null,
"documenttypeserie": null,
"customer": null,
"paymentmethod": null,
"paymentcondition": null,
"shippingmode": null,
"shippingvat": null,
"price": null,
"currency": null,
"vehicle": null,
"employee": null,
"items": [],
"vats": [],
"createdby": null,
"finishedby": null,
"canceledby": null,
"accountopen": null
}
Sugerimos que teste e valide a resposta completa numa plataforma de testes de API como por exemplo Postman ou Insomnia.