eVIR tudásbázis

Main goal: Create invoices based on the rental data from C-Rent

• Test system URL: https://hertz.evir.hu/proba-evir/
  • User/Pass: (you got via email)
  • Start page: list of the received records

• API call:
  • URL: https://hertz.evir.hu/proba-evir/cgi-bin/index.cgi
  • Function (dok key): hertz_crent_invoice_felvesz
  • Authentication token: (you got via email)

API Communication can be a single JSON object via POST method:

• URL: https://hertz.evir.hu/proba-evir/cgi-bin/index.cgi
• method: POST
• content-type: text/json or application/json

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:

• „status” key contains „OK” value.
• „invoice_id” contains the internal ID of the transferred invoice data.

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é"
        }
      ]
  }
}

Vat type is a text value, maximum 20 character.

Constraints and values according to NAV Onlineszamla specifications …

Basic types used at text scalar values.

They are represented as JSON text values.

Number are used for money values. …

New fields:

• Payments.*.CardNumber
• Payments.*.AuthorizationCode

For information only, these payment methods currently exist in eVIR: