Ez a dokumentum egy előző változata!
Main goal: Create invoices based on the rental data from C-Rent
hertz_crent_invoice_felvesz
API Communication can be a single JSON object via POST method:
The posted content:
{ "token":".....", "dok":"hertz_crent_invoice_felvesz", "invoice":{ "Partner":{ ... }, ... } }
The embedded JSON data structure of field invoice
is detailed below.
The return value of the successful C-Rent → eVIR data transfer must be a JSON data structure in the following format:
[ { "status":"OK", "invoice_id":9, .... (other elements) } ]
If eVIR could store the data then the return value contains the followings:
In case of missing „status” key with „OK” value, or the result is not a JSON object, then it means error, the data is not stored.
The structure may have additional fields.
{ "Partner":{ "Id": 183409, "Name": "BC.HU Kft.", "Type": "COMPANY", "TaxNumber": "23882991-2-42", "Address": { "Country": "HU", "PostalCode": "1155", "City": "Budapest", "StreetName": "Wysocki", "PublicPlaceCategory": "utca", "Number": "3" } }, "Payments": [ { "Id": "00600", "Method": "VIS", "Value": 127 } ], "PaymentDate": "2021-06-31", "DeliveryDate": "2021-06-15", "GrossValue": 127, "Currency": "EUR", "ExchangeRate": 348.48, "Language": "HU", "Comment": "Example invoice", "InvoiceAppearance": "PAPER", "InvoiceLines": [ { "Article": { "ArticleNumber": "HTZHU-28", "Description": "Renting a car", "UnitOfMeasure": "db", "Type": "SERVICE", "Vat": "27" "LedgerAccount": "93130", }, "Quantity": 1, "NetValue": 100, "Comment": "Example comment" } ], "Contract": { "ContractNumber": "76999987", "ReservationNumber": "1278954765", "OfficeCode": "HUBUD14", "Cost": "54000", "Events": [ { "PlateNumber": "ABC-123", "CarModel": "Opel", "CarCategory": "C", "CheckOut": { "OfficeCode": "HUBUD14", "Date": "2021-06-13", "Time": "09:35", "Km": 19975 }, "CheckIn":{ "OfficeCode": "HUBUD14", "Date": "2021-06-14", "Time": "15:50", "Km": 21560 }, "PlannedKm": 1500 } ], "Drivers":[ { "Name": "Teszt Elek", "Email": "test@example.com" }, { "Name": "Teszt Elekné" } ] } }
Fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Partner | partner object | mandatory | Invoice is issued to this parnter | |
Payments | Array of payment objects | 1 or more elements mandatory | ||
PaymentDate | date | Should not be less than current date | 2021-08-31 | |
DeliveryDate | date | 2021-08-15 | ||
GrossValue | number | Gross value calculated from lines, VAT included | 6337 | |
Currency | currency | EUR | ||
ExchangeRate | number | If currency is HUF then this value must be 1.00 | 1 unit of the above currency is equivalent to X HUF | 348.48 |
Language | language | The language of the invoice | EN | |
Comment | text | - | Free text, copied into comment of invoice | |
InvoiceId | text | - | unique id of the invoice RE*-1 GS*-1 RE*-2 … | RE769999876-1 |
InvoiceAppearance | enum | Currently only allowed value is 'PAPER' | onleszamla 2.3.5. | PAPER |
InvoiceLines | Array of invoice lines | |||
Contract | contract object |
Fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Article | article object | |||
Quantity | number | The quantity of the article | 1 | |
NetValue | number | The unit price of the article | 4990.00 | |
Comment | text | Comment for the invoice line |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Id | Number | Positive integer, Mandatory, not changing over time for the same partner | Unique key | 1025 |
Name | text | 90 character | The name of the partner | Example Ltd. |
Type | enum | PERSON or COMPANY | The type of the partner. | COMPANY |
TaxNumber | tax number | Hungarian domestic tax number | 12345678-4-23 | |
VatGroupMembership | tax number | Hungarian VAT group membership | 98765432-5-23 | |
CommunityVatNumber | text | 20 character | Community vat number | DE12345678 |
ThirdStateTaxId | text | 20 character | Tax id outside of EU | |
Address | address object | Address |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Country | country | Mandatory | Address | HU |
PostalCode | text | 10 character, mandatory | Postal code | 2220 |
City | text | 40 character, mandatory | City | Vecsés |
StreetName | text | 60 character, mandatory | Street name | Kossuth Lajos |
PublicPlaceCategory | text | 40 character | The category of the Hungarian public place (eg. street, avenue, square) | utca |
Number | text | 20 character | 1 | |
Building | text | 40 character | ||
Staircase | text | 20 character | ||
Floor | text | 20 character | ||
Door | text | 20 character |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
ArticleNumber | text | 20 character | Uniqe identifier of the article in the eVIR | HTZHU-28 |
Description | text | 512 character | Description of the article | Car renting |
UnitOfMeasure | text | 10 character | Unit of measure, existing in the eVIR | db |
Type | enum | Only supported value: SERVICE | SERVICE | |
Vat | vat type | Vat code | 27 | |
LedgerAccount | text | 10 number | Ledger account number | 93130 |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Id | text | numbers | Payment ID for DKS | 00600 |
Method | text | must exist in eVIR see table below | VIS | |
Value | number | amount paid | 127 | |
CardNumber | text | card number | ??? | |
AuthorizationCode | text | authorization code | ??? |
Vat type is a text value, maximum 20 character.
Value | Description | Example value | Meaning |
---|---|---|---|
Integer | Vat rate is X % | 27 | 27% VAT |
Text | Vat rate is 0 %, Code expresses the reason of 0% VAT according to eVIR | TAM | See: onlineszamla 2.2.3.2.1. |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
ContractNumber | text | Identifier of contract | 769999876 | |
ReservationNumber | text | Identifier of reservation | ||
TacoIata | text | Taco/Iata | ||
FrequentFlyer | text | Frequent flyer | ||
OfficeCode | text | Valid office codes | Office code | HUBUD14 |
Cost | text | cost code needed by Mercur | Cost code | 54000 |
Events | Array of renting event objects | |||
Drivers | Array of driver objects |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
PlateNumber | text | Plate number | ABC-123 | |
CarModel | text | Opel | ||
CarCategory | text | C | ||
CheckOut | checkpoint object | Check out event details | ||
CheckIn | checkpoint object | Check in event details | ||
PlannedKm | Number | Planned Km | 150 |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
OfficeCode | text | Value office code | Office code | |
Date | date | Date | 2021-06-14 | |
Time | time | Time | 13:50 | |
Km | number | Checkpoint Km |
fieldname | Datatype | Constraints | Description | Examples |
---|---|---|---|---|
Name | text | |||
text | Valid email address |
Constraints and values according to NAV Onlineszamla specifications …
Basic types used at text scalar values.
They are represented as JSON text values.
Type | Length | Text Regexp | Description | Examples |
---|---|---|---|---|
date | 10 | [0-9]{4}-[0-9]{2}-[0-9]{2} | Using the syntax YYYY-MM-DD (Year-Month-Day). Must be greate than 2010-01-01 | 2021-06-29 |
time | 5 | [0-9]{2}:[0-9]{2} | Hour 0-23 Minute 0-59 | 09:59 |
currency | 3 | [A-Z]{3} | The currency of the invoice according to configured currencies in eVIR | EUR, HUF |
language | 2 | [A-Z]{2} | The language of the invoice. Currently supported values are only 'EN' and 'HU' | EN |
tax_number | 13 | [0-9]{8}-[1-5]-[0-9]{2} | Tax number format used in Hungary | 12345678-1-23 |
country | 2 | [A-Z]{2} | Country code in ISO-3166 | HU |
Number are used for money values. …
New fields:
For information only, these payment methods currently exist in eVIR:
Method | Description in eVIR |
---|---|
AMX | American Express |
VIS | Visa Card |
EAS | Europ Assistance |
CSH | Cash-Eurocheque |
CTW | Cartrawler |
HCC | Hertz Cred.Card/OTTO |
VCH | Voucher |
DIN | Diners Club |
CRE | Bank Transfer |
TRF | TRF |
T00 | Banki átutalás |
T14 | átutalás(14) |
T15 | 15 napos banki átutalás |
T30 | 30 napos banki átutalás |
T04 | 4 napos banki átutalás |
T08 | 8 napos banki átutalás |
EUR | Eurocard/Mastercard |
Field | Type | Description | Source | example |
---|---|---|---|---|
CRFIR | N2 | System type | eVIR | 10: production 99:devel/test |
CRBKZ | C | eVIR | F T | |
CRRED | D | Issue date of invoice | eVIR | 20220401 |
CREVIR | C8 | Invoice number | eVIR | S0000001 |
CRART | C2 | eVIR | RA GS ZA | |
CRZKS | C/N | Payer customer id | C-Rent | 00600 |
CRZKH | C/N | Income customer id | C-Rent | 214183 |
CRKDN | C/N | Customer id | C-Rent | 214183 |
CRSAK | N | Ledger account number | C-Rent | 93130 |
CRZAC | C3 | HUF | eVIR | HUF |
CRGSN | N | HUF Net amount | eVIR | |
CRGSS | N | HUF VAT amount | eVIR | |
CGGSB | N | HUF Gross Amount | eVIR | |
CRZAF | C3 | Currency | C-Rent | EUR |
CRKUR | N | Exchange rate | C-Rent | 348.48 |
CFGFN | N | Net amount | C-Rent | |
CFGFS | N | VAT amount | eVIR | |
CFGFB | N | Gross amount | eVIR | |
CRSTC | C3 | VAT code | C-Rent | F27 |
CRFAD | D | Payment date | C-Rent | 20220415 |
CRFAT | N | days between payment and invoice issue date | eVIR | 14 |
CRKOS | C/N | Cost code | C-Rent | 54000 |
CRKZ1 | C | Plate number | C-Rent | XMPL01 |
CRTEX | C | Free text | C-Rent | |
CREVIRO | C | Modified invoice number | C-Rent | |
CRCCZM | C | Payment method? | C-Rent | |
CRAUTOR | C | Authorization code? | C-Rent | |
CRCRNUM | C | Contract number | C-Rent | RE866711746-1 |
CRDKUKZ | C | - | ||
CRDKUDT | N | - | 0 |
Abbreviation | Type |
---|---|
Cn | Character with length (n) |
Nn | Numeric with length (n) |
D | Date in format YYYYMMDD |
Keyword | |
---|---|
eVIR | generated by eVIR |
C-Rent | C-Rent provide |