Nutec Factura-e / NSIGES
Getting Started
The Nutec Factura-e API allows you to send and receive electronic documents:
Interact with Nutec Factura-e by managing various entities such as Invoices, Clients, Contacts, Delivery Methods, etc. Integrate data from an external application (management system or ERP) to create and send electronic invoices and retrieve data on status changes, invoice history, and more.
Testing Environment You can use our mock server https://644e1604-952c-45c5-8ee1-925e09b42f27.mock.pstmn.io to check our apis.
Prod Enviroment You can use our prod server https://developer.nutec.cloud but first you will need a valid "api-key"
Factura-e
GETList Invoice
Returns a paginated list of the submitted invoices of the company
URL PARAMS
- api-key : string required is the customer's identification key
Responses 200 - Successful operation 401 - Unauthorized 403 - Forbidden 404 - Invoice not found
GETGet Invoice
Returns information about a specific invoice, it can be an issued invoice or a received invoice
api-key string required is the customer's identification key
id integer required An internal identifier that is unique to each Invoice.
Responses 200 - Successful operation 401 - Unauthorized 403 - Forbidden 404 - Invoice not found
PUTUpdate Invoice
Update a specific invoice.
BODY PARAMS invoice object
example: { invoice: { number: '3', file_reference: 'string', date: '2020-11-12', due_date: '2021-01-04', state: 'refused', invoice_lines_attributes: [ { position: 1, quantity: 0, price: 0, description: 'string', unit: 1, discount_amount: 0, discount_percent: 0, discount_text: 'string', charge_amount: 0, charge_percent: 0, charge_reason: 'string', taxes_attributes: [ { name: 'string', category: 'S', percent: 0, comment: 'string' } ], article_code: 'string', article_code2: 'string', article_code2_scheme: 'string', article_code_buyer: 'string', classification_code: 'string', classification_code_scheme: 'string', client_reference: 'string', delivery_note_date: '2023-12-04', delivery_note_number: 'string', file_reference: 'string', file_date: '2023-12-04', invoicing_period_start: '2023-12-04', invoicing_period_end: '2023-12-04', issuer_transaction_reference: 'string', issuer_transaction_date: '2023-12-04', notes: 'string', ponumber: 'string', receiver_transaction_date: '2023-12-04', receiver_contract_reference: 'string', receiver_contract_date: '2023-12-04', sequence_number: 0 } ], payment_dues_attributes: [{due_date: '2023-12-04', amount: 0}], client_id: 0, client: { taxcode: '9920:ESD29766391', name: 'string', address: 'string', address2: 'string', postalcode: 'string', city: 'string', province: 'string', country: 'string', email: 'string', pin_value: 'string', pin_scheme: 'string' }, description: 'string', tax_report_description: 'string', charge_amount: 0, charge_percent: 0, charge_reason: 'string', discount_amount: 'string', discount_percent: 'string', discount_text: 'string', taxes_attributes: [ { name: 'string', category: 'S', percent: 0, comment: 'string' } ], currency: 'EUR', amounts_withheld: 0, amounts_withheld_reason: 'string', accounting_cost: 'string', bank_account: 'string', bank_assigned_creditor_reference: 'string', iban: 'string', bic: 'string', transport_type_code: 'es.efact', document_type_code: 'xml.facturae.3.2', download_legal_url: 'string', invoicing_period_start: '2023-12-04', invoicing_period_end: '2023-12-04', frequency: 0, delivery_address: 'string', delivery_address2: 'string', delivery_city: 'string', delivery_country: 'string', delivery_date: '2023-12-04', delivery_location_type: 'string', delivery_note_date: '2023-12-04', delivery_note_number: 'string', delivery_postalcode: 'string', delivery_province: 'string', buyer_reference: 'string', lot_reference: 'string', mandate_reference_identifier: '321654', party_identification: '5060012349998', customer_party_identification: '5060012349998', extra_info: 'string', payment_method: 1, payment_method_text: 'string', payment_terms: 'string', reminder_for_payment: true, payment_reminder_days: 0, language: 'string', client_email_override: 'john_doe@example.net, jane_doe@example.net', company_email_override: 'string', contact: 'string', contract_number: 'string', issuer_contract_date: '2023-12-04', order_date: '2023-12-04', ponumber: 'string', sales_order_reference: 'string', receiver_contract_reference: 'string', receiving_advice_reference: 'string', series_code: 'string', tax_point_date: '2023-12-04', dire: 'string', legal_literals: 'string', legal_text: 'string', terms: 'custom', remittance_information: 'string', fa_address: 'string', fa_bank_code: 'string', fa_bic: 'string', fa_clauses: 'string', fa_country: 'string', fa_duedate: '2023-12-04', fa_iban: 'string', fa_import: 0, fa_info: 'string', fa_name: 'string', fa_payment_method: 'string', fa_person_type: 'string', fa_postcode: 'string', fa_province: 'string', fa_residence_type: 'string', fa_taxcode: 'string', fa_town: 'string', num_contracte: 'string', oficina_comptable: 'string', oficina_comptable_name: 'string', organ_gestor: 'string', organ_proponent: 'string', special_regime_key: '01', unidad_contratacion: 'string', unitat_tramitadora: 'string', unitat_tramitadora_name: 'string', amended_number: 'string', amended_series_code: 'string', amended_date: 'string', amend_code_tax: 'R1', type_operation: 'services', amended_invoicing_period_start: '2023-12-04', amended_invoicing_period_end: '2023-12-04', amend_reason: 'string', correction_method: 'string' } }
URL PARAMS
api-key : string required is the customer's identification key
id : integer required An internal identifier that is unique to each Invoice.
RESPONSES 204 - Successful update 400 - Invalid status value 422 - Unprocessable Entity