Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

User/bcri/20241009 cb customer data fr appendix #331

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
+39 −0
Open

User/bcri/20241009 cb customer data fr appendix #331

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
5a588d8
add the CbCustomer data part to Data structure in FR appendix
Bluette-C-Riviere Oct 9, 2024
b576512
Update data-structures.md
Bluette-C-Riviere Oct 10, 2024
0af3a6c
Update data-structures.md
Bluette-C-Riviere Oct 10, 2024
ee5b1c3
Merge branch 'master' into user/bcri/20241009-CbCustomer-data-fr-appe…
Bluette-C-Riviere Oct 10, 2024
a149962
Update data-structures.md
Bluette-C-Riviere Oct 21, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions doc/middleware-fr-boi-tva-decl-30-10-30/data-structures/data-structures.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,45 @@ For French law fulfilment, a net-amount by line is required. This is added by a

There are no special requirements or laws for the French market.

#### Customer data `cbCustomers`

If you need to provide customer data in your request, you can send it in via the field `cbCustomer` by filling it JSON format with following fields:

| **Field name** | **Data type** | **Default Value Mandatory Field** | **Description** | **Version** |
|-------------------|---------------------------------|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|
| `CustomerName` | `string (50)` | Optional | **Name of beneficiary customer.** <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerName` e.g. `"cbCustomer":"{"CustomerName":"Martin Dupont",...}"` | 1.2 |
| `CustomerId` | `string (50)` | Optional | **ID of the beneficiary customer.** <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerId ` e.g. `"cbCustomer":"{"customerName":"Martin Dupont", "CustomerId":"PX9819822", ...}"` | 1.2 |
| `CustomerType` | `string (50)` | Optional | **Type of the beneficiary customer** (e.g. employee). <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerType` e.g. `"cbCustomer":"{..., "CustomerId":"Martin Dupont", "CustomerType":"Particulier", ...}"` | 1.2 |
| `CustomerStreet` | `string (60)` | Optional | **Street and house number of the beneficiary customer.** <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerStreet` e.g. `"cbCustomer":"{..., "CustomerStreet":"Rue de la Paix 1", ...}"` | 1.2 |
| `CustomerZip` | `string (10)` | Optional | **Zip of the beneficiary customer.** <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerZip` e.g. `"cbCustomer":"{..., "CustomerZip":"75009", ...}"` | 1.2 |
| `CustomerCity` | `string (62)` | Optional | **City of the beneficiary customer**. <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerCity` e.g. `"cbCustomer":"{..., "CustomerCity":"Paris", ...}"` | 1.2 |
| `CustomerCountry` | `ISO 3166 ALPHA-3 country code` | Optional | **Country of the beneficiary customer.** <br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerCountry` e.g. `"cbCustomer":"{..., "CustomerCountry":"FRANCE", ...}"` | 1.2 |
| `CustomerVATId` | `string(15)` | Optional | **VAT-ID of the beneficiary customer.**<br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerVATId` e.g. `"cbCustomer":"{..., "CustomerVATId":"FR12345678901", ...}"` | 1.2 |
| `CustomerSIRET` | `string(15)` | Optional | **VAT-ID of the beneficiary customer.**<br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerSIRET` e.g. `"cbCustomer":"{..., "CustomerSIRET":"12345678900012", ...}"` | 1.2 |
| `CustomerSIREN` | `string(15)` | Optional | **VAT-ID of the beneficiary customer.**<br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerSIREN` e.g. `"cbCustomer":"{..., "CustomerSIREN":"123456789 ", ...}"` | 1.2 |
| `CustomerRCS` | `string(15)` | Optional | **VAT-ID of the beneficiary customer.**<br />Send via `cbCustomer` in JSON format by adding the key value pair `CustomerRCS` e.g. `"cbCustomer":"{..., "CustomerRCS":"RCS: Paris B 123 456 789 ", ...}"` | 1.2 |

#### Issuer data `cbIssuer`

If you need to provide the invoice issuer data in your request, you can send it in via the field `cbIssuer` by filling it JSON format with following fields:

| **Field name** | **Data type** | **Default Value Mandatory Field** | **Description** | **Version** |
|-------------------|---------------------------------|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|
| `IssuerName` | `string (50)` | Optional | **Name of the invoice issuer.** <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerName` e.g. `"cbIssuer":"{"IssuerName":"SARL Dupont",...}"` | 1.2 |
| `IssuerId` | `string (50)` | Optional | **ID of the invoice issuer.** <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerId ` e.g. `"cbIssuer":"{"IssuerName":"SARL Dupont", "IssuerId":"PX9819822", ...}"` | 1.2 |
| `IssuerStreet` | `string (60)` | Optional | **Street and house number of the invoice issuer.** <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerrStreet` e.g. `"cbIssuer":"{..., "IssuerStreet":"Allée du Rosier 1", ...}"` | 1.2 |
| `IssuerZip` | `string (10)` | Optional | **Zip of the invoice issuer.** <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerZip` e.g. `"cbIssuer":"{..., "IssuerZip":"75004", ...}"` | 1.2 |
| `IssuerCity` | `string (62)` | Optional | **City of the invoice issuer**. <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerrCity` e.g. `"cbIssuer":"{..., "IssuerCity":"Paris", ...}"` | 1.2 |
| `IssuerCountry` | `ISO 3166 ALPHA-3 country code` | Optional | **Country of the invoice issuer.** <br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerCountry` e.g. `"cbIssuer":"{..., "IssuerCountry":"FRANCE", ...}"` | 1.2 |
| `IssuerVATId` | `string(15)` | Optional | **VAT-ID of the invoice issuer.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerVATId` e.g. `"cbIssuer":"{..., "IssuerVATId":"FR12345678901", ...}"` | 1.2 |
| `IssuerSIRET` | `string(15)` | Optional | **SIRET number of the invoice issuer only for french registered companies.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerSIRET` e.g. `"cbIssuer":"{..., "IssuerSIRET":"12345678900012", ...}"` | 1.2 |
| `IssuerSIREN` | `string(15)` | Optional | **SIREN number of the invoice issuer only for french registered companies.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerSIREN` e.g. `"cbIssuer":"{..., "IssuerSIREN":"123456789 ", ...}"` | 1.2 |
| `IssuerRCSInfo` | `string(15)` | Optional | **RCS identifiers of the invoice issuer.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerRCSInfo` e.g. `"cbIssuer":"{..., "IssuerRCS":"RCS: Paris B 123 456 789 ", ...}"` | 1.2 | | 1.2 |
| `IssuerTradeDirectoryNumber` | `string(15)` | Optional | **Trade Directory Number of the invoice issuer for non french registered companies.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerTradeDirectoryNumber` e.g. `"cbIssuer":""{..., "IssuerTradeDirectoryNumber":"Trade Directory Number: EU1234567890 ", ...}"` | 1.2 |
| `IssuerNAFCode` | `string(15)` | Optional | **NAF Code of the invoice issuer only for french registered companies.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerNAFCode` e.g. `"cbIssuer":""{..., "IssuerNAFCOde":"NAF Code: 00012", ...}"` | 1.2 |
| `IssuerVATPaymentOption` | `string(15)` | Optional | **VAT payment option of the invoice issuer.**<br />Send via `cbIssuer` in JSON format by adding the key value pair `IssuerVATPaymentOption` e.g. `"cbIssuer":"{..., "IssuerVATPaymentOption: Payment of VAT on receipts", ...}"` | 1.2 |


### Signature Entry

A Signature Entry can include an electronic signature for printing on the receipt and further information regarding the operational state of the fiskaltrust.SecurityMechanism. Furthermore, but only when receipts with special functions are used, the previous state of the totalizers (in case of a temporal closure), can also be sent back in this block.
Expand Down