New Light partners with Greenstep to bring agentic finance to the NordicsLight partners with Greenstep Read the announcement

API/Reference/EInvoicing

Update self-billed e-invoice

PATCH 
https://api.light.inc/v1/einvoicing/self-billed-einvoices/{id}

Updates a draft or failed self-billed e-invoice. Fields left out keep their value.

Authorization

Send one of these on every request. See Authentication for how to get credentials.

  • API key

    Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

  • Bearer token

Path parameters

  • id string · uuidrequired

Request body

application/json;charset=UTF-8

  • issueDate string · date

    The date on the self-billed e-invoice

  • documentNumber string

    The number on the supplier's document

  • documentDate string · date

    The date of the supplier's document

  • supplierName string

    The supplier's name

  • supplierVatNumber string

    The supplier's VAT number

  • supplierBusinessRegistrationNumber string

    The supplier's business registration number

  • supplierAddress object

    • country string

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

    • city string

      Note

      City.

    • state string

      Note

      State or region, where the country uses one.

    • zipcode string

      Note

      Postal code.

    • street string

      Note

      First address line.

    • street2 string

      Note

      Second address line.

  • sdiTdCode string

    The SDI document type code

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of TD16 TD17 TD18 TD19 TD20 TD21 TD22 TD23 TD28

Response

  • id string · uuid

  • companyEntityId string · uuid

  • accountingDocumentId string · uuid

    The accounting document the e-invoice was created for. Null once the accounting document is deleted

  • accountingDocumentType string

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of AP AR BP CC CN CT DE FX JE YC

  • linkedSelfBilledEInvoiceId string · uuid

  • type string

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of SELF_BILLED_CREDIT_NOTE SELF_BILLED_INVOICE

  • network string

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of FINVOICE FR_PA MYDATA NEMHANDEL PEPPOL PORTUGUESE_TAX_REPORTING SDI VERIFACTU

  • selfBilledEInvoiceNumber string

  • issueDate string · date

    The date on the self-billed e-invoice

  • deadline string · date

    The last day to send the e-invoice to the network

  • documentNumber string

    The number on the supplier's document

  • documentDate string · date

    The date of the supplier's document

  • currency string

  • amount integer · int64

    Total amount in cents, expressed in the invoice currency.

  • netAmount object

    • amount integer · int64

      Note

      Unsigned integer in minor units. The direction is in dcSign; a negative value is rejected.

    • dcSign string

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of D C

  • taxAmount object

    • amount integer · int64

      Note

      Unsigned integer in minor units. The direction is in dcSign; a negative value is rejected.

    • dcSign string

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of D C

  • buyerName string

  • buyerVatNumber string

  • buyerBusinessRegistrationNumber string

  • supplierName string

  • supplierVatNumber string

  • supplierBusinessRegistrationNumber string

  • areLinesWithTax boolean

    How the accounting document's amounts were entered: true means with tax. Line amounts in this response are always net

  • buyerAddress object

    • country string

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

    • city string

      Note

      City.

    • state string

      Note

      State or region, where the country uses one.

    • zipcode string

      Note

      Postal code.

    • street string

      Note

      First address line.

    • street2 string

      Note

      Second address line.

  • supplierAddress object

    • country string

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

    • city string

      Note

      City.

    • state string

      Note

      State or region, where the country uses one.

    • zipcode string

      Note

      Postal code.

    • street string

      Note

      First address line.

    • street2 string

      Note

      Second address line.

  • lines array of object

    • description string

    • ledgerTaxId string · uuid

      The tax code's ID as stored on the line

    • taxName string

      The tax code's name as stored on the line

    • edifactCode string

      The tax code's UNCL5305 code as stored on the line

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AE E G K L M O S Z

    • taxCategory string

      Whether the tax code is for goods or for services, as stored on the line

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of GOODS SERVICES

    • quantity number

    • rate number

      The tax rate as a fraction, so 0.22 is 22%

    • netTransactionAmount object

      • amount integer · int64

        Note

        Unsigned integer in minor units. The direction is in dcSign; a negative value is rejected.

      • dcSign string

        ⚠️ This enum is not exhaustive; new values may be added in the future.

        One of D C

    • taxTransactionAmount object

      • amount integer · int64

        Note

        Unsigned integer in minor units. The direction is in dcSign; a negative value is rejected.

      • dcSign string

        ⚠️ This enum is not exhaustive; new values may be added in the future.

        One of D C

    • countryProperties object

      The tax code's country property values, by group internal name, as stored on the line

  • status string

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of ACCEPTED ARCHIVED DRAFT FAILED SUBMITTED

  • failureContext object

    Failure context when vendor onboarding fails.

    • name string

      The error name

    • type string

      The error type

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of BAD_REQUEST UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_CONTENT

    • errors array of object

      List of errors providing details about what went wrong

      • type string

        A string code identifying the error type

      • message string

        A human-readable message providing more details about the error

      • path array of string

        Optional path of the error when the error is for a specific field. Used mostly on BAD_REQUEST errors, that path will match the field name on the request object

      • context object

        Optional context providing additional information about the error. This can include any relevant data that might help in understanding or resolving the error

  • einvoiceId string

  • submittedAt string · date-time

  • editedFields array of string

    The fields a user changed. Updates from the accounting document keep their values

    One of DOCUMENT_DATE DOCUMENT_NUMBER ISSUE_DATE SDI_TD_CODE SUPPLIER_ADDRESS SUPPLIER_BUSINESS_REGISTRATION_NUMBER SUPPLIER_NAME SUPPLIER_VAT_NUMBER

  • createdAt string · date-time

  • sdiTdCode string

    The SDI document type code. Only set on the SDI network

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of TD16 TD17 TD18 TD19 TD20 TD21 TD22 TD23 TD28