Vendas - Sumário

—

Permite calcular em tempo real os totais (total de iva, total geral, etc) que vão ser emitidos no documento.

document_type mixed required

Tipo de documento. Pode ser enviado o ID ou o descritivo, exemplo: Factura, Factura Recibo, Factura Simplificada, Nota de Crédito, Nota de Débito, Factura Pró-forma, Orçamento, Encomenda, Consulta de Mesa, Guia de Transporte, Guia de Remessa, Guia de Consignação, Guia de Devolução, Guia de movimentação de activos próprios.

final_discount_financial double

Desconto financeiro €

final_discount_global double

Desconto global %

shipping_mode mixed

Modo de expedição. Pode ser enviado o ID ou o descritivo, exemplo: Correios, Comboio, etc.

shipping_value double

Custo unitário da despesa de transporte

shipping_vat mixed

Taxa de IVA da despesa de transporte. Pode ser enviado o ID, descritivo ou a taxa, exemplo: 23, 13, etc.

currency mixed

Moeda utilizada. Pode ser enviado o ID, símbolo ou descritivo, exemplo: €, $, Euro, Dólar. No caso de não preenchimento será assumido a moeda pré-definida.

currency_exchange double

Câmbio da moeda. Caso não seja enviado será assumido 1.

vat_type string required

Tipo de IVA. Deve ser enviado um dos seguintes valores: Debitar IVA, IVA incluído, Não fazer nada.

irs_retention_tax double

Taxa de retenção na fonte

items json array required

Lista de artigos que constam no documento.

id mixed required

ID ou referência do artigo

details string 255 chars max

Descrição adicional a aparecer no documento

price double required

Preço unitário

quantity double required

Quantidade

discount double

Desconto percentual

vat mixed required

Taxa de IVA a aplicar. Pode ser enviado o ID, descritivo ou a taxa, exemplo: 23, 13, etc.

vat_exemption mixed

Isenção de IVA a aplicar. Pode ser enviado o ID ou o código, exemplo: M08, etc. No caso de não preenchimento será assumido o valor M18 - Sem isenção.

URL

https://facturalusa.pt/api/v2/sales/summary

Método

post

Resposta

200

{
    "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",
    "total_services": "0.00",
    "total_quantity": "0.00",
    "irs_retention_apply": false,
    "irs_retention_base": "0.00",
    "irs_retention_total": "0.00",
    "irs_retention_tax": "0.00",
    "items": [],
    "vats": []
}

Sugerimos que teste e valide a resposta completa numa plataforma de testes de API como por exemplo Postman ou Insomnia.

Vendas - Assinar digitalmente Vendas - Procurar

Introdução

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 - Sumário