Receipt.New

post

https://api.rivhit.co.il/online/RivhitOnlineAPI.svc/Receipt.New

Create a New Receipt

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

api_token

uuid

required

Rivhit Merchant API Identifier.

Default: No

receipt_type

integer

required

Receipt type.

Range: 0 to 999
Default: No

customer_id

integer

required

Rivhit Customer Identifier.

Range: 0 to 999999999
Default: No

last_name

string

required

Customer Last Name/Company Name.

Length: 1 to 30
Default: Customer details

first_name

string | null

Customer First Name.

Length: 1 to 20
Default: Customer details

address

string | null

Customers Address.

Length: 1 to 30
Default: Customer details

city

string | null

Customer's city.

Length: 1 to 20
Default: Customer details

zipcode

integer | null

Customers Zipcode.

Range: 0 to 9999999
Default: Customer details

phone

string | null

Customer Phone Number.

Length: 1 to 15
Default: Customer details

acc_ref

string | null

Customer Outer System Identifier.

Length: 1 to 9
Default: No

id_number

integer | null

Customer Israeli Id (by Custom Format).

Range: 8-9 digits
Default: No

issue_date

date

Issue Date of the receipt.

~ Date format DD-MM-YY or DD/MM/YYYY
Length: 1 to 10
Default: Current day

issue_time

string | null

^([01]?[0-9]|2[0-3]):([0-5]?[0-9])$

Issue time of the receipt.

~ Time format HH:MM
Length: 1 to 5
Default: Current time

reference

integer | null

The Reference Value - Will be Saved in the Invoice.

Range: 0 to 9999999999
Default: Rivhit settings

comments

string | null

The Customer Comments (to print on the invoice).

Length: 1 to 400
Default: Rivhit system settings

agent_id

integer | null

Agent Id Serial Number (Rivhit system).

Range: 0 to 999999999
Default: Customer details

project_id

integer | null

Project Id Serial Number (Rivhit system).

Range: 0 to 999999999
Default: No

currency_id

integer | null

Receipt Currency Type.

Options: (1 = NIS 2 = USD 3 = EURO 4 = GBP 5 = AUD 6 = CAD 7 = CHF 8 = SEK 9 = DKK 10 = NOK)
Default: Receipt settings

exchange_rate

double | null

Fixed Currency Exchange Rate to ILS.

~ From MTC to ILS
Range: Decimal limit (only positive)
Default: Rivhit Settings

crm_user_id

integer

CRM User Id (Set the Receipt Producer).

Range: 0 to 99999
Default: Rivhit user settings

language

string | null

enum

Set the Receipt Language.

Options: (he/en)
Default: he

Allowed:

email_to

string | null

Customer Email Address.

Length: 6 to 50
Default: Customer details

email_bcc

string | null

Bcc Email Address.

Length: 6 to 50
Default: Rivhit mailing settings

digital_signature

boolean | null

Produce the Receipt With a Digital Signature.

true = With digital signature
Default: false

signature_pin

string | null

The Digital Signature PIN Code.

~ Send only by API support instructions
Length: 3 to 6
Default: No

payments

array of objects

required

payments*

check_only

boolean | null

Activate Check Mode.

~ Response will include status and error message.
Default: false

request_reference

string | null

The Receipt Request Reference.

~ Combine with prevent_duplicates
~ Should be unique value
Length: 2GB
Default: No

prevent_duplicates

boolean | null

Activate Prevent Duplicates.

~ Combine with request reference
Default: No

create_customer

boolean | null

Create a New Customer in Rivhit System.

~ When exsiting customer can't be found
Default: false

send_mail

boolean | null

Send the Receipt to the Customer.

Default: true

find_by_mail

boolean | null

Locate Customer by Email Address.

Default: false

find_by_id

boolean | null

Locate Customer by Israeli Id/VAT Number.

Default: false

find_by_acc_ref

boolean | null

Locate Customer by the acc_ref.

Default: false

find_by_phone

boolean | null

Locate Customer by Phone Number.

Default: false

receipt_number

integer

Set the Starting Number for a New Receipt.

~ Only when it is the first receipt
Range: 1 to 99999
Default: Receipts settings

closed_document_type

integer

Set the Type of Existing Document to be closed.

~ Combine with ClosedDocumentNumber
Range: 1 to 999
Default: No

closed_document_number

integer

Set the Number of Existing Document to be closed.

~ combine with ClosedDocumentType
Range: 1 to 999999
Default: No

country

string

Customer Country.

Length: 1 to 39
Default: Customer details

state

string

Customer State.

Length: 1 to 10
Default: No

foreign_zipcode

string | null

Customer Foreign Zip Code.

Length: 1 to 7
Default: No

thermal_print

boolean | null

Activate Thermal Print.

Default: false

logo_url

url | null

The Business Logo - Printed on the Receipt.

Length: 15 to 400
Default: Rivhit system settings

default_email

boolean

Use the Default Customer Mail Address.

Default: false

item_id

integer

Rivhit Item Identifier (For Delayed Receipts).

~ This item id will be defined in the future invoice.
Range: 0 to 999999999
Default: 0

items

array of objects

items

Responses

200Success - Receipt Created

400Request Error

500Internal Server Error