Facturalusa - Software de Facturação Online

Vendas - Actualizar

Apenas pode ser utilizado caso o documento se encontre em rascunho.

sale_reference_id integer

ID da venda a ser referenciada. Apenas deve ser preenchido quando o documento a ser emitido se trata de uma Nota de crédito ou Nota de débito e há uma referência a uma Factura, Factura Simplificada ou Factura Recibo.

issue_date date required

Data de emissão do documento

due_date date

Data de vencimento do 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.

serie mixed

Série. Pode ser enviado o ID ou o descritivo, exemplo: 2021, 2021A, etc. No caso de não preenchimento será assumido a série pré-definida.

final_discount_financial double

Desconto financeiro €

final_discount_global double

Desconto global %

customer integer required

ID do cliente

vat_number string

Contribuinte do cliente. No caso de não preenchimento será assumido o valor 999999990.

address string required

Morada do cliente

city string required

Localidade do cliente

postal_code string required

Código postal do cliente

country string required

País do cliente

delivery_address_address string

Morada de entrega

delivery_address_city string

Localidade da morada de entrega

delivery_address_postal_code string

Código postal da morada de entrega

delivery_address_country string

País da morada de entrega

payment_method mixed

Forma de pagamento. Pode ser enviado o ID ou o descritivo, exemplo: Numerário, Transferência bancária, etc.

payment_condition mixed

Condição de pagamento. Pode ser enviado o ID ou o descritivo, exemplo: Pronto pagamento, 30 dias, etc.

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.

price mixed

Tabela de preços utilizada. Pode ser enviado o ID ou o descritivo, exemplo: Preços público, Preços revenda, 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.

observations string

Observações do documento

irs_retention_tax double

Taxa de retenção na fonte

vehicle mixed

Veículo utilizado. Este campo apenas deve ser utilizado quando o tipo de documento emitido se trata de uma guia. Pode ser enviado o ID, matrícula ou nome.

employee mixed

Vendedor do documento. Pode ser enviado o ID ou o email.

waybill_shipping_date datetime required if waybill

Data de início de transporte da guia.

waybill_global boolean

Determina se a guia se trata de uma guia global de transporte. Esta opção só pode ser utilizada se o documento a emitir se tratar de uma Guia de Transporte ou Guia de Remessa. Se activo, os campos: customer, vat_number, address, city, postal_code, country, delivery_address_address, delivery_address_city, delivery_address_postal_code, delivery_address_country, discharge_location e location_destiny deixam de ter a obrigatoriedade de preenchimento e serão sempre automaticamente preenchidos pelo Facturalusa com as informações do cliente genérico.

location_origin mixed

Local de origem. Pode ser enviado o ID ou nome do local. No caso de não preenchimento será assumido o local de origem pré-definido.

location_destiny mixed

Local de destino. Pode ser enviado o ID ou nome do local. Não será assumido nenhum valor se não for enviado nada.

cargo_location string

Localidade de carga

discharge_location string

Localidade de descarga

cargo_date datetime

Data de carga

discharge_date datetime

Data de descarga (prevista)

items json array required

Lista de artigos que constam no documento.

id mixed required

ID ou referência do artigo

details string

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.

language string

Idioma a ser impresso caso o estado do documento seja Terminado. Preencher com PT ou EN. No caso de não preenchimento será assumido o idioma pré-definido.

format string

Formato a ser impresso caso o estado do documento seja Terminado. Preencher com A4, POS ou EscPOS. No caso de não preenchimento será assumido o valor definido no tipo de documento (que por norma é A4).

Os formatos A4 e POS produzem um ficheiro PDF.

O formato EscPOS produz um ficheiro TXT com os comandos da impressora em Base64.

paper_size integer

Tamanho / largura do documento em milímetros. Apenas deve ser preenchido caso o formato seja POS ou EscPOS. No caso de não preenchimento será assumido o valor definido no tipo de documento.

paper_left_margin integer

Margem à esquerda do documento. No caso de não preenchimento será assumido o valor definido no tipo de documento.

paper_right_margin integer

Margem à direita do documento. No caso de não preenchimento será assumido o valor definido no tipo de documento.

paper_top_margin integer

Margem em cima do documento. No caso de não preenchimento será assumido o valor definido no tipo de documento.

paper_bottom_margin integer

Margem em baixo do documento. No caso de não preenchimento será assumido o valor definido no tipo de documento.

force_print boolean

Determina se deve ou não gerar a impressão do documento caso o estado do mesmo seja Terminado. Se preenchido com true o documento será impresso; Se preenchido com false o documento não será impresso; se não for preenchido, irá assumir o valor definido no tipo de documento.

force_send_email boolean

Determina se deve ou não enviar via email o documento para o cliente caso o estado do mesmo seja Terminado. Se preenchido com true o documento será enviado; Se preenchido com false o documento não será enviado; se não for preenchido, irá assumir o valor definido no tipo de documento.

force_send_sms boolean

Determina se deve ou não enviar SMS para o cliente caso o estado do documento seja Terminado. Se preenchido com true a SMS será enviada; Se preenchido com false a SMS não será enviada; se não for preenchido, irá assumir o valor definido no tipo de documento. Esta funcionalidade só funciona se tiver SMS disponíveis.

force_sign boolean

Determina se deve ou não assinar o documento caso o estado do documento seja Terminado e caso o mesmo seja impresso. Se preenchido com true o documento será assinado; se preenchido com false o documento não será assinado; se não for preenchido, irá assumir o valor definido no tipo de documento. Esta funcionalidade só funciona se tiver a Assinatura Digital activada e bem configurada.

status string required

Estado do documento. Deve ser enviado um dos seguintes valores: Rascunho ou Terminado.

🍪 Usamos cookies no nosso site para melhorar a sua experiência. Ao continuar, declara aceitar a nossa Política de Cookies.