createAccountingEntry

Note

There are two highly simplified methods for adding accounting entries, createAccountingEntryUsingCodes and createAccountingEntryUsingIds, which handle all use cases for adding such entries.

These two methods now fully cover the functionality of the old method, so it is strongly recommended to stop using this old method and replace it with one of the two new methods.

HTTP	Operation	Type	Object	DTO Why-DTOs?
POST	Create	Mutation	`createAccountingEntry`	`AccountingEntryCreateGLDtoInput`

Description

Old and deprecated approach to creating an accounting entry.
This method can become intricate due to the rules that must be adhered to.

Thus, as createAccountingEntry is now DEPRECATEDThis object is now deprecated, and we recommend using an alternative solution, it is recommended to explore the capabilities of createAccountingEntryUsingCodes or createAccountingEntryUsingIds, depending on your preference.

Caution

Given the model of the accounting entries and the mandatory object types in the context of purchase or sale journal entries, we absolutely recommend that you start with an example from the postman collection and adapt it rather than starting from scratch.

To see examples of mutations that include the adding of accounting entries :
download the Postman collection: Quick start / 5. Test your first query in Postman

Would you like to see an example of how to add an entry?

This example concerns a sales invoice, to transform it into a purchase invoice, just :

replace origin CUSTOMER by SUPPLIER
replace registerType ISSUED by RECEIVED
Assign a third party Supplier instead of a Customer

{
  "values": {
    "description": "Facture FA0022",
    "date": "2023-03-01",
    "entryType": "GENERAL",
    "journalTypeId": "{journalId}",
    "accountingEntryLines": [
      {
        "description": "Facture FA0022",
        "creditAmount": 0,
        "debitAmount": 1824.67,
        "subAccountId": "{customerAccountId}",
        "accountingEntryThirdParty": {
          "socialName": "{customerSocialName}",
          "origin": "CUSTOMER",
          "thirdPartyId": "{customerId}",
          "identificationTypeId": "{documentTypeId}",
          "documentId": "{customerDocumentId}",
          "vatNumber": "{vatNumber}"
        },
        "registerType": "ISSUED",
        "accountingEntryInvoice": {
          "amount": 1824.67,
          "documentDate": "2023-03-01",
          "expeditionDate": "2023-03-01",
          "operationDate": "2023-03-01",
          "settlementDate": "2023-03-01",
          "externalInvoiceNumber": "FA0022",
          "registerType": "ISSUED"
        }
      },
      {
        "description": "Facture FA0022",
        "creditAmount": 1520.56,
        "debitAmount": 0,
        "subAccountId": "{AccountId}",
        "registerType": "UNDEFINED"
      },
      {
        "description": "Facture FA0022",
        "creditAmount": 304.11,
        "debitAmount": 0,
        "subAccountId": "{taxAccountId}",
        "registerType": "UNDEFINED"
      }
    ]
  }
}

Key	Value
`Authorization`	Bearer Current access Token How to find?
`X-TenantId`	Current tenant id How to find?
`X-OrganizationId`	Current organization Id How to find?
`x-api-key`	Primary or secondary subscription key of your app How to find?

accountingEntries

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

date *The value of the field or object is mandatory	Datetime DateThe GraphQL field type is DateTime, but only the date value is considered, the time value is ignored if provided.	Date
journalTypeId *The value of the field or object is mandatory NThe value of this field cannot be modified after the record is created	UUID	Journal Id
number RThis field is read-only, its value cannot be assigned	Decimal	Number See InfoAdditional information is available in the Info block below
entryType *The value of the field or object is mandatory	GENERAL	Always fill in GENERAL
description	String	Description See InfoAdditional information is available in the Info block below	200
closeDate InvThis field is not visible in the product interface RThis field is read-only, its value cannot be assigned	Datetime DateThe GraphQL field type is DateTime, but only the date value is considered, the time value is ignored if provided.	closing date of entry
isClosed RThis field is read-only, its value cannot be assigned	Boolean	True if closed
accountingEntryLines[]	Array	List of all lines of entry See InfoAdditional information is available in the Info block below

Info

number : operational Number Counter Id
description: A value used as a template for lines from the interface.

This value is optional

This value is optional

This value is mandatory.
accountingEntryLines : List of lines in the accounting entry, the accounting entry must be balanced, the total of the lines with a debit must be equal to the total of the lines with a credit. Adding an unbalanced entry will return an error.

accountingEntries/accountingEntryLines

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

subAccountId *The value of the field or object is mandatory	UUID	Id of accountingAccount
description	String	Description	200
debitAmount *The value of the field or object is mandatory	Decimal	Amount debit See InfoAdditional information is available in the Info block below
creditAmount *The value of the field or object is mandatory	Decimal	Amount credit See InfoAdditional information is available in the Info block below
registerType *The value of the field or object is mandatory	UNDEFINED ISSUED RECEIVED BOTH	Type of tax register See InfoAdditional information is available in the Info block below	6
accountingEntryThirdParty	ObjectType	ThirdParty See InfoAdditional information is available in the Info block below
accountingEntryInvoice	ObjectType	Invoice See InfoAdditional information is available in the Info block below

Info

creditAmount, debitAmount : The accounting entry must be balanced, the total of the lines with a debit must be equal to the total of the lines with a credit. Adding an unbalanced entry will return an error.
registerType : used for tax registers, mandatory value.
- For journal types equal to GENERAL or FINANCIAL or CARRY_FORWARD, always assign UNDEFINED for each line.
- For journals types equal to PURCHASE_INVOICE or SALES_INVOICE :
  - For lines without a third party CUSTOMER or SUPPLIER, always assign UNDEFINED
  - For lines with a third party CUSTOMER, assign ISSUED
  - For lines with a third party SUPPLIER, assign RECEIVED
accountingEntryThirdParty : mandatory for lines with a third party CUSTOMER, SUPPLIER, EMPLOYEE.
accountingEntryInvoice : mandatory for lines with a third party CUSTOMER, SUPPLIER for journal types PURCHASE_INVOICE or SALES_INVOICE. Must not be defined for other journals.

It is not possible to group several invoices in one accounting entry for the journals PURCHASE_INVOICE or SALES_INVOICE.
So only one accountingEntryThirdParty and one accountingEntryInvoice per accountingEntry for these journals.

accountingEntries/accountingEntryLines/accountingEntryThirdParty

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

thirdPartyId *The value of the field or object is mandatory	UUID	Third Id See InfoAdditional information is available in the Info block below
socialName *The value of the field or object is mandatory	String	Third Name See InfoAdditional information is available in the Info block below	70
code RThis field is read-only, its value cannot be assigned	String	Code See InfoAdditional information is available in the Info block below	17
origin *The value of the field or object is mandatory	UNDEFINED CUSTOMER SUPPLIER EMPLOYEE	Type of third
identificationTypeId *The value of the field or object is mandatory	UUID	DocumentType Id See InfoAdditional information is available in the Info block below
documentId *The value of the field or object is mandatory	String	Document Id See InfoAdditional information is available in the Info block below	25
vatNumber	String	vat Number See InfoAdditional information is available in the Info block below	25

Info

thirdPartyId : Third party id :
- If journal type equal to PURCHASE_INVOICE the third party is a Supplier.
- If journal type equal to SALES_INVOICE the third party is a Customer.
- In the other cases, the third party can be a Supplier, Customer or Employee.
socialName : Found in the third party as socialName for customer & supplier and name for employee, must be filled in.
code : Found in the third party as code, must be filled in.
identificationTypeId : Found in the third party as documentTypeId, must be filled in.
documentId : Found in the third party as documentId, must be filled in.
vatNumber : VAT Number of the third party.

A value is not mandatory in the context of FR legislation.

A value is mandatory in the context of ES legislation if the third party is part of the VIES system and is not an ES third party.

A value is mandatory in the context of DE legislation if the third party is part of the VIES system and is not an DE third party.

accountingEntries/accountingEntryLines/accountingEntryInvoice

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id

documentDate *The value of the field or object is mandatory	Datetime	Document date
expeditionDate *The value of the field or object is mandatory InvThis field is not visible in the product interface	Datetime	Expedition date See InfoAdditional information is available in the Info block below
operationDate *The value of the field or object is mandatory InvThis field is not visible in the product interface	Datetime	Operation date See InfoAdditional information is available in the Info block below
settlementDate *The value of the field or object is mandatory InvThis field is not visible in the product interface	Datetime	Settlement date See InfoAdditional information is available in the Info block below
externalInvoiceNumber *The value of the field or object is mandatory	String	Invoice number	50
amount *The value of the field or object is mandatory	Decimal	Amount
registerType *The value of the field or object is mandatory	UNDEFINED ISSUED RECEIVED BOTH	Type of tax register See InfoAdditional information is available in the Info block below	6
accountingEntryTaxes[]	Array	Tax registers

Info

expeditionDate : mandatory, assign it by default with documentDate.
operationDate : mandatory, assign it by default with documentDate.
settlementDate : mandatory, assign it by default with documentDate.
amount : Amount of the invoice, must be equal to the amount of the entry line where the third party is present (accountingEntryThirdParty)
registerType : used for tax registers, mandatory value.
- For customer invoice, assign ISSUED
- For supplier invoice, assign RECEIVED

accountingEntries/accountingEntryLines/accountingEntryInvoice/accountingEntryTaxes

Fields	Type	Description
idSSystem field that cannot be assigned	UUID	Id

taxTreatmentId	UUID	Id of the tax Treatment See InfoAdditional information is available in the Info block below
taxGroupId	UUID	Id of the Taxe Group of tax treatment See InfoAdditional information is available in the Info block below
taxType		Tax Type of the tax treatment See InfoAdditional information is available in the Info block below
taxId	UUID	Id Tax found by groupId=taxGroupId See InfoAdditional information is available in the Info block below
taxPercentage	Decimal	Percentage of the tax found by groupId=taxGroupId See InfoAdditional information is available in the Info block below
taxBase	Decimal	Base of tax calculation
taxAmount	Decimal	Tax amount
deductible	Boolean	true for a deductible tax, false for a collected tax
regimeType	GENERAL	Always fill in GENERAL

Info

taxTreatmentId : A tax Treatment must be associated to each line of acounting Entry taxes. see Taxes Treatments
taxGroupId : found in Taxes Treatments
taxType : found in Taxes Treatments
taxId : Id of the taxe found by groupId of tax = taxGroupId of Tax Treatment
taxPourcentage : Pourcentage of the taxe found in tax

DEPRECATEDThis object is now deprecated, and we recommend using an alternative solution

Note

Description

Caution

Would you like to see an example of how to add an entry?

Header

accountingEntries

Info

accountingEntries/accountingEntryLines

Info

accountingEntries/accountingEntryLines/accountingEntryThirdParty

Info

accountingEntries/accountingEntryLines/accountingEntryInvoice

Info

accountingEntries/accountingEntryLines/accountingEntryInvoice/accountingEntryTaxes

Info