{"product_id":"n8n-workflow-validate-portuguese-nif-draft-invoice-receipt-in-invoicexpress","title":"n8n Workflow: Validate Portuguese NIF \u0026 Draft Invoice-Receipt in InvoiceXpress","description":"\u003ch3\u003eValidate Portuguese NIFs \u0026amp; generate a draft Invoice-Receipt in InvoiceXpress—automatically\u003c\/h3\u003e\n\u003cp\u003eThis n8n workflow manually runs to validate Portuguese NIF tax IDs, confirm your configured VAT taxes in \u003cstrong\u003eInvoiceXpress\u003c\/strong\u003e, and then create a \u003cstrong\u003edraft invoice-receipt (fatura-recibo)\u003c\/strong\u003e via the \u003cstrong\u003eInvoiceXpress API\u003c\/strong\u003e, returning the new document ID, totals, and any validation warnings.\u003c\/p\u003e\n\n\u003ch3\u003eWhat this workflow does\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003eRuns on demand\u003c\/strong\u003e (manual execution) using provided sample payment data.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eNormalizes payment fields\u003c\/strong\u003e—customer, NIF, items, amount, and VAT rate—into a consistent internal structure.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eValidates VAT and NIF:\u003c\/strong\u003e checks payment totals and VAT rates, verifies the Portuguese NIF check digit, and (based on your settings) falls back to \u003cstrong\u003e“Consumidor final”\u003c\/strong\u003e when the NIF is missing or invalid.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eVerifies taxes in InvoiceXpress:\u003c\/strong\u003e calls the InvoiceXpress API to list available taxes and ensures each configured tax name exists with the expected percentage (from your \u003ccode\u003etaxas_iva\u003c\/code\u003e mapping).\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eBuilds the InvoiceXpress payload\u003c\/strong\u003e using net unit prices, selected taxes, and optional series and tax-exemption reason.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eCreates a draft document\u003c\/strong\u003e and outputs the \u003cstrong\u003ecreated document ID\u003c\/strong\u003e, \u003cstrong\u003etotal\u003c\/strong\u003e, and any validation warnings.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eUse cases\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003ePre-check payments before creating documents in InvoiceXpress to reduce tax\/VAT mismatches.\u003c\/li\u003e\n  \u003cli\u003eAutomate invoice-receipt creation for Portuguese customers while enforcing NIF validity.\u003c\/li\u003e\n  \u003cli\u003eStandardize VAT handling by confirming configured tax names and percentages directly against InvoiceXpress.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eTechnical details\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003e\n\u003cstrong\u003en8n nodes:\u003c\/strong\u003e Manual Trigger, Set, Code, Sticky Note, HTTP Request.\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eIntegration:\u003c\/strong\u003e \u003cstrong\u003eInvoiceXpress API\u003c\/strong\u003e (HTTP Request steps).\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eAuthentication:\u003c\/strong\u003e Use an n8n HTTP Custom Auth credential that sends \u003ccode\u003eapi_key\u003c\/code\u003e as a query string (e.g., \u003ccode\u003e{ \"qs\": { \"api_key\": \"YOUR_API_KEY\" } }\u003c\/code\u003e).\u003c\/li\u003e\n  \u003cli\u003e\n\u003cstrong\u003eConfiguration:\u003c\/strong\u003e Update \u003ccode\u003einvoicexpress_base_url\u003c\/code\u003e (e.g., \u003ccode\u003ehttps:\/\/YOUR-ACCOUNT.app.invoicexpress.com\u003c\/code\u003e).\u003c\/li\u003e\n\u003c\/ul\u003e","brand":"N8N Commerce","offers":[{"title":"Default Title","offer_id":46203574124723,"sku":"N8N-20752","price":45.99,"currency_code":"GBP","in_stock":true}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0749\/6279\/6723\/files\/1ebsRYxBt9jejLRzetw1g_67Qh0Rtl.png?v=1791709631","url":"https:\/\/buyflowscripts.com\/products\/n8n-workflow-validate-portuguese-nif-draft-invoice-receipt-in-invoicexpress","provider":"N8N Commerce","version":"1.0","type":"link"}