Overriding Invoice Account Details in the Request

Your terminal settings define the default document type for invoicing commands, as well as your business and EZcount account details.

In some cases, you may need more flexibility in document generation. To support this, Hyp allows you to override the default invoicing configuration using the following parameters:

• invoiceType: overrides the default document type (usually a tax receipt). Possible values:

  • tax (חשבונית מס, tax invoice): standard VAT invoice issued when a sale is made and VAT is charged.

  • receipt (קבלה, non-tax receipt): confirms receipt of payment without creating a VAT liability. Only available if the item price does not include VAT.

  • taxreceipt (חשבונית מס קבלה, tax invoice receipt, or tax receipt): combines a VAT invoice and a receipt acknowledging payment.

  • receiptdonation (קבלת תרומה, donation receipt): issued by nonprofit organizations to acknowledge donations. Only available if the item price does not include VAT.

  • order (הזמנת עבודה / הזמנת שירות / הזמנה, order confirmation): confirms an order before an invoice is issued.

  • pricequote (הצעת מחיר, price quotation): proposes prices and terms to a customer.

  • transactionaccount (חשבון עסקה, proforma invoice): preliminary sale document sent ahead of the tax invoice.

• invoiceVendorKey: specifies a different EZcount account than the one defined in your terminal to generate the invoice.

You can include these parameters in the invoice element of an addCgInvoice or refundCgInvoice request just like any other parameter.

FAQ

Can I issue all document types with an override?

No. You can only issue document types allowed by your EZcount account configuration. For example, an Osek Patur (עוסק פטור) cannot issue a tax invoice via any EZcount account, because this is legally prohibited and therefore blocked by Hyp.