Invoice entity

Run my Accounts differs between two types of invoice and credit notes: Customer invoices or customer transactions.

  • Customer invoices describes invoices using positions with parts. Income account and taxes will be defined in the part used in a position.
  • Customer transactions describe invoices using income accounts and by directly defining tax amounts on vat accounts.

Both types share some elements:

ElementDescriptionDefaultTypeMandatory
invnumberUnique key identifying the invoiceTEXTYes
ordnumberOrder numberTEXT
statusOPEN, PAID, OVERDUEOPEN
currencyThree character currency codeCHFTEXT(3)
ar_accnoAccounts receivable account number1100TEXT
payment_accnoDefines the payment account on which the payment is expected.TEXT
transdateInvoice dateDATEYes
duedateDATE
descriptionInvoice titleTEXT
notesTEXT
intnotesInternal notes usually not printed on the invoiceTEXT
taxincludedPrices included taxes or notBOOLEAN
dcnESR NumberTEXT

Customer invoices

Additional elements required in customer invoices:

ElementDescriptionDefaultTypeMandatory
partsList of part elements describing the invoice descriptionpartYES

Examples

XML:

<?xml version="1.0" encoding="UTF-8"?>
<invoice>
   <invnumber>R-002</invnumber>
   <ordnumber />
   <status>OVERDUE</status>
   <currency>CHF</currency>
   <ar_accno>1100</ar_accno>
   <transdate>2012-08-06T00:00:00+02:00</transdate>
   <duedate>2012-08-06T00:00:00+02:00</duedate>
   <description />
   <notes />
   <intnotes />
   <taxincluded>false</taxincluded>
   <dcn />
   <customer>
      <id>10199</id>
      <customernumber>K-001</customernumber>
      <name>Muster AG</name>
      <created>2012-02-21T00:00:00+01:00</created>
      <contactId>0</contactId>
      <salutation>Herr</salutation>
      <firstname>Hans</firstname>
      <lastname>Muster</lastname>
      <addressId>0</addressId>
      <address1>Rössliweg 1</address1>
      <address2 />
      <zipcode />
      <city>Tenna</city>
      <state />
      <country />
      <phone />
      <fax />
      <mobile />
      <email>hmuster@muster.ch</email>
      <taxnumber />
      <taxfree>false</taxfree>
      <bank_name>CREDIT SUISSE</bank_name>
      <bank_address1 />
      <bank_address2 />
      <bank_zipcode>8070</bank_zipcode>
      <bank_city>ZÜRICH</bank_city>
      <bank_country>SCHWEIZ</bank_country>
      <bank_iban>CH3304835172037151000</bank_iban>
      <bank_bic>CRESCHZZ80L</bank_bic>
   </customer>
   <parts>
      <part>
         <income_accno>3000</income_accno>
         <partnumber>ART-1</partnumber>
         <description>Beispiel Artikel 1</description>
         <unit />
         <quantity>5.0</quantity>
         <sellprice>99.0</sellprice>
         <discount>0.0</discount>
         <itemnote />
         <price_update>2012-08-06T09:29:05.857+02:00</price_update>
      </part>
   </parts>
</invoice>

JSON:

{
   "invnumber": "R-002",
   "ordnumber": "",
   "status": "OVERDUE",
   "currency": "CHF",
   "ar_accno": "1100",
   "transdate": "2012-08-06T00:00:00+02:00",
   "duedate": "2012-08-06T00:00:00+02:00",
   "description": "",
   "notes": "",
   "intnotes": "",
   "taxincluded": "false",
   "dcn": "",
   "customer":
   {
       "id": "10199",
       "customernumber": "K-001",
       "name": "Muster AG",
       "created": "2012-02-21T00:00:00+01:00",
       "contactId": "0",
       "salutation": "Herr",
       "firstname": "Hans",
       "lastname": "Muster",
       "addressId": "0",
       "address1": "Rössliweg 1",
       "address2": "",
       "zipcode": "",
       "city": "Tenna",
       "state": "",
       "country": "",
       "phone": "",
       "fax": "",
       "mobile": "",
       "email": "hmuster@muster.ch",
       "taxnumber": "",
       "taxfree": "false",
       "bank_name": "CREDIT SUISSE",
       "bank_address1": "",
       "bank_address2": "",
       "bank_zipcode": "8070",
       "bank_city": "ZÜRICH",
       "bank_country": "SCHWEIZ",
       "bank_iban": "CH3304835172037151000",
       "bank_bic": "CRESCHZZ80L"
   },
   "parts":
   {
       "part":
       {
           "income_accno": "3000",
           "partnumber": "ART-1",
           "description": "Beispiel Artikel 1",
           "unit": "",
           "quantity": "5.0",
           "sellprice": "99.0",
           "discount": "0.0",
           "itemnote": "",
           "price_update": "2012-08-06T09:30:54.679+02:00"
       }
   }
}

Customer transactions

Customer transactions require two addtional elements. incomeentries list all income accounts and their amounts. taxentries list all vat accounts and the tax amounts:

incomeentry element

ElementDescriptionDefaultTypeMandatory
amountDOUBLEYES
income_accnoIncome account numberTEXTYES
descriptionTEXT

taxentries element

ElementDescriptionDefaultTypeMandatory
amountDOUBLEYES
tax_accnoVAT account numberTEXTYES

Examples

XML:

<?xml version="1.0" encoding="UTF-8"?>
<invoice>
   <invnumber>R-001</invnumber>
   <ordnumber />
   <status>OVERDUE</status>
   <currency>CHF</currency>
   <ar_accno>1100</ar_accno>
   <transdate>2012-08-06T00:00:00+02:00</transdate>
   <duedate>2012-08-06T00:00:00+02:00</duedate>
   <description />
   <notes />
   <intnotes />
   <taxincluded>false</taxincluded>
   <customer>
      <id>10199</id>
      <customernumber>K-001</customernumber>
      <name>Muster AG</name>
      <created>2012-02-21T00:00:00+01:00</created>
      <contactId>0</contactId>
      <salutation>Herr</salutation>
      <firstname>Hans</firstname>
      <lastname>Muster</lastname>
      <addressId>0</addressId>
      <address1>Rössliweg 1</address1>
      <address2 />
      <zipcode />
      <city>Tenna</city>
      <state />
      <country />
      <phone />
      <fax />
      <mobile />
      <email>hmuster@muster.ch</email>
      <taxnumber />
      <taxfree>false</taxfree>
      <bank_name>CREDIT SUISSE</bank_name>
      <bank_address1 />
      <bank_address2 />
      <bank_zipcode>8070</bank_zipcode>
      <bank_city>ZÜRICH</bank_city>
      <bank_country>SCHWEIZ</bank_country>
      <bank_iban>CH3304835172037151000</bank_iban>
      <bank_bic>CRESCHZZ80L</bank_bic>
   </customer>
   <incomeentries>
      <incomeentry>
         <amount>99.0</amount>
         <income_accno>3400</income_accno>
         <description />
      </incomeentry>
   </incomeentries>
   <taxentries>
      <taxentry>
         <amount>7.92</amount>
         <tax_accno>2201</tax_accno>
      </taxentry>
   </taxentries>
</invoice>

JSON:

{
   "invnumber": "R-001",
   "ordnumber": "",
   "status": "OVERDUE",
   "currency": "CHF",
   "ar_accno": "1100",
   "transdate": "2012-08-06T00:00:00+02:00",
   "duedate": "2012-08-06T00:00:00+02:00",
   "description": "",
   "notes": "",
   "intnotes": "",
   "taxincluded": "false",
   "customer":
   {
       "id": "10199",
       "customernumber": "K-001",
       "name": "Muster AG",
       "created": "2012-02-21T00:00:00+01:00",
       "contactId": "0",
       "salutation": "Herr",
       "firstname": "Hans",
       "lastname": "Muster",
       "addressId": "0",
       "address1": "Rössliweg 1",
       "address2": "",
       "zipcode": "",
       "city": "Tenna",
       "state": "",
       "country": "",
       "phone": "",
       "fax": "",
       "mobile": "",
       "email": "hmuster@muster.ch",
       "taxnumber": "",
       "taxfree": "false",
       "bank_name": "CREDIT SUISSE",
       "bank_address1": "",
       "bank_address2": "",
       "bank_zipcode": "8070",
       "bank_city": "ZÜRICH",
       "bank_country": "SCHWEIZ",
       "bank_iban": "CH3304835172037151000",
       "bank_bic": "CRESCHZZ80L"
   },
   "incomeentries":
   {
       "incomeentry":
       {
           "amount": "99.0",
           "income_accno": "3400",
           "description": ""
       }
   },
   "taxentries":
   {
       "taxentry":
       {
           "amount": "7.92",
           "tax_accno": "2201"
       }
   }
}

 

War dieser Artikel hilfreich?
Dislike 0
Ansichten: 49