> For the complete documentation index, see [llms.txt](https://developers.hyp.co.il/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.hyp.co.il/enterprise/documents-and-invoicing/overview.md).

# Overview of Documents and Invoicing

For generating invoices and other documents, the Hyp Enterprise API works in tandem with [EZcount](https://www.ezcount.co.il/), an invoicing service provider that is a wholly owned subsidiary of Hyp.

The specific type of document that the Hyp Enterprise API and EZcount generate by default is determined by a terminal setting, which the Hyp team configures based on the merchant's business type.

In many cases, the default will be tax invoice receipts (also known as tax receipts), but you can also generate other kinds of documents such as tax invoices, receipts, price quotes, and more — see [Overriding Invoice Account Details](/enterprise/documents-and-invoicing/overriding-invoice-account-details-in-the-request.md) for the full list.

In this section, when we say "invoice", we mean any document generated by the Hyp Enterprise invoicing API.

You can generate invoices for regular transactions, as well as for refunds and payouts. Technically, there are three Hyp Enterprise API commands related to invoicing:

* `addCgInvoice` — generates invoices for regular debit transactions and payouts. See [Issuing Invoices](/enterprise/documents-and-invoicing/issuing-invoices.md).
* `refundCgInvoice` — generates invoices for refunds and cancellations. See [Invoicing for Refunds](/enterprise/documents-and-invoicing/refund-invoices.md).
* `inquireInvoice` — fetches previously generated invoices. See [Invoice Inquiries](/enterprise/documents-and-invoicing/invoice-inquiries.md).

In addition to using these Hyp Enterprise API commands, you can manage previously generated invoices using the EZcount portal.

## FAQ

### When you generate an invoice, is it sent to the customer via email?

Yes, unless you explicitly disable this. You can also access the invoice using the URL provided in the Hyp Enterprise API response.

### Can you add invoice creation automatically to a payment page?

No. To generate invoices, you should use the two standalone commands: `addCgInvoice` and `refundCgInvoice`. Hyp Enterprise no longer allows including invoice-related elements in the `doDeal` and `refundDeal` commands. Using specialized invoicing commands significantly streamlines troubleshooting, which benefits both you as a merchant and the Hyp support team.

### How to issue invoices retroactively?

There is no time limit on when you can generate an invoice for a past transaction — it can be immediately after the transaction occurs or at any later time. Simply [create a normal `addCGInvoice` request](/enterprise/documents-and-invoicing/issuing-invoices.md) after the transaction has taken place.

### Does Hyp Enterprise support חשבוניות ישראל (Tax Authority Allocation Number)?

Yes. It is configured automatically for you when you sign up for EZcount, and no additional action is required on your part as a merchant.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.hyp.co.il/enterprise/documents-and-invoicing/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
