{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"9e179f6d-6503-4fcc-8959-04a411028efc","name":"Documents API","description":"API version 1.4.5  \nEZcount documents API is a REST-API for documents creation.\n\n# Quick start\n\n## Code samples\n\nPHP / JAVA / .NET / ASP / RUBY / NODE / PYTHON code samples\n\nWe have built an SDK to make your life much easier, and now you can connect with simple copy-paste from the SDK demo.\n\nYou may download the SDK’s from the next links:\n\n- [C#.NET](https://www.dropbox.com/s/i3so75fvsl42z4f/EZcount.net.example.zip?dl=1)\n    \n- [VB.NET](https://www.dropbox.com/s/i3so75fvsl42z4f/EZcount.net.example.zip?dl=1)\n    \n- [PHP](https://www.dropbox.com/s/83rnhzxg1m3e1i9/EZcount.php.example.zip?dl=1)\n    \n- [JAVA](https://www.dropbox.com/s/gtd1i6k4k8enfj1/EZcount.java.example.zip?dl=1)\n    \n- [ASP](https://www.dropbox.com/s/sfvy1dnbaynsay9/EZcount.asp.classic.zip?dl=1)\n    \n- [Python](https://www.dropbox.com/s/dhld65btz1d2y9e/EZcount.phython.2.example.zip?dl=1)\n    \n- [Ruby](https://www.dropbox.com/s/6xf0xx6k4w2ps3t/EZcount.ruby.example.zip?dl=1)\n    \n- [Node.js](https://www.dropbox.com/s/adt0apsmmbuevax/EZcount.NodeJs.example.zip?dl=1)\n    \n\n# Overview\n\n- JSON request must be sent with `application/json` header\n    \n- The API connection must be established through SSL (port 443)\n    \n- Please make sure your connection timeout settings are above 30sec.Generally, responses are returned in several milliseconds, but it might get to several seconds when the server is busy, so please go on the safe side.\n    \n- The API has a sandbox (demo) environmentPlease register freely into this environment, and get your API key.  \n    ([https://demo.ezcount.co.il](https://demo.ezcount.co.il))\n    \n- **Types warning:** please follow the types as described in the documentation.We use loosely casting, so sending a string instead of a boolean will be converted to `TRUE`.For example, sending the string `“FALSE”` instead of a boolean false will be converted to boolean `TRUE`.\n    \n- The API is asynchronous, and we create the PDF file AFTER the success response.  \n    if you wish to download the documents automatically, it’s advised to wait at least 5 min, for making sure that all the background processes have finished. If you are getting code 429 from the server, the documents are not ready yet.\n    \n- The number of characters of all the comments in the doc (i.e., doc comment, items comments, payments comments) is limited to 10,000.\n    \n\n### **Tax Authority**\n\n- When the document is waiting for the Tax Authority allocation number we will return status `417`.\n    \n- To receive the relevant Tax Authority error, you can view it from our documents dashboard interface or set and listen to the Tax Authority webhook.\n    \n- When the document is not accessible and the status code is `417` You need to use the four options:\n    \n    - [Skip the Tax Authority allocation number](#c30471b0-db04-46e3-98cf-0db5fcc32091)\n        \n    - [Cancel the documents.](#d02a0eea-46a2-4dd1-b964-6f795095ae7a)\n        \n    - [Further objection of Tax Authority](#dfc6f4ab-9dd4-42f8-965c-350f093f2ce3)\n        \n    - [Reverse Tax](#a5f5e3f1-38a7-4031-80b3-dfe41a727544) - Cancel the invoice and initiate a document with **zero percent VAT**.  \n        The end customer needs to create a self-invoice document.\n        \n    - **Optional:** set your own Tax Authority allocation number\n        \n- **Important notice for distributors:** When the request status code is `417` and the error code is `460` While accessing the document via API request, You need to return to the document creator the Tax Authority message:\n    \n\n_להלן התגובה של רשות המסים:_  \nהריני להודיעך כי מבדיקה שנערכה ביחס לבקשתך לקבל מספר הקצאה לחשבונית המס,  \nבשלב זה, לא ניתן מספר הקצאה לחשבונית מאחר וקיים חשש כי מדובר בחשבונית שהוצאה שלא כדין, בין היתר מהטעם שמוציא החשבונית אינו מי שהוסמך להוציאה ו/או מדובר בעסקה חריגה ו/או אחד מהפרטים שהוזנו לגבי החשבונית אינו משקף את פרטי העסקה ו/או אינו נכון.\n\n> **NOTE**:  \nwe made the API very easy for you to use, so you will be able to create documents with minimum effort, and there are only a few mandatory fields, they are listed under the column of the required parameters table with a \"V\" letter for each of the required fields. \n  \n\n## Rate limit\n\nThe API has a rate limit of 250 requests per 10 seconds.\n\nWhile you are doing batch documents creation, please consider it.\n\nPlease consider sending the requests one after another and not in parallel.\n\notherwise, you might hit our firewall DOS mitigation rate limiter and will be blocked for 1 minute.\n\n> **NOTE**: API errors rate limit is 100 failures per hour. \n  \n\n## API domains:\n\n- **demo.ezcount.co.il** - use for testing\n    \n- **api.ezcount.co.il** - use for production, the API key is different between domains so you’ll have to get a new one when going to production.\n    \n\n## Requirements\n\n1. fully setup account with a digital signature in EZcount.co.il / demo\n    \n2. API key from the system under `Settings->API` menu\n    \n\n## Testing API key\n\nTo acquire an API key for testing, you may register (for free, forever), go to **demo**.ezcount.co.il and get an API key and customize your account.\n\nIf you want quick and dirty, and you don’t care about the UI\\\\look of the invoices during development, you may use the next **testing API key**:\n\n`f1c85d16fc1acd369a93f0489f4615d93371632d97a9b0a197de6d4dc0da51bf`\n\n(when using this API key, we will NOT send the email to the customer, if you want the email to be sent in the testing process, please open your own account under **demo**.ezcount.co.il and approve your email)\n\n## Testing notes\n\n- The test environment is for development only. Please DO NOT send any sensitive \\\\ confidential data to this environment.\n    \n- The environment is not built for stress testing. Please contact us for mass documents testing.\n    \n- Due to regulations, documents, data, and inactive users in the test environment will be deleted after 6 months.\n    \n\n# How to create a document\n\n#### base document parameters\n\nin order to create a new document, you must call the API with the following parameters below.\n\n> **Required explanations:** \n  \n\n- V - always required\n    \n- !R - required in all documents except receipt\n    \n- ?R - optional in all documents except receipt\n    \n- !DR - required in **Receipt Donation Refund (410)**\n    \n    - Must include a **parent reference** to the original **Receipt Donation (405)**.\n        \n    - Must contain the **exact same payment information (type,amount etc..)** as in the original document.\n        \n    - **Partial refunds are not allowed** – the refund must fully match the original receipt.\n        \n\n| API KEY | VALUE TYPE | REQUIRED | DESCRIPTION |\n| --- | --- | --- | --- |\n| **api_key** | SHA256 | V | Your API key |\n| **developer_email** | String | V | The developer email uses contact with the developer/contact person in case of any API problems/updates. |\n| **type** | Numeric | V | `100`, הזמנה (Order)  <br>`200`, תעודת משלוח (Delivery)  <br>`210`, תעודת החזרה (Return)  <br>`300`, חשבונית עסקה (Proforma Invoice)  <br>`305`, חשבונית מס(Tax invoice)  <br>`320`, חשבונית מס קבלה(Invoice Receipt)  <br>`330`, חשבונית זיכוי(Credit invoice)  <br>`400`, קבלה(Receipt)  <br>`405`, קבלה על תרומה(Receipt for donation)  <br>`410` ביטול קבלה על תרומה(Receipt for donation refund)  <br>`500`, הזמנת רכש(Purchase order)  <br>`9999`, הצעת מחיר(Bid)  <br>`9998`, קבלת פקדון (Deposit Approval)  <br>`9997`, קבלת פקדון (Deposit Release) |\n| **created_by_api_key** | SHA256 |  | **Distributors accounts only**  <br>If you are creating documents on behalf of multiple EZcount users, please send this key, so we’ll know that you are the origin of the request. |\n| **transaction_id** | String / UUID |  | Recommended but not enforced, a system-wide unique identifier that indicates this doc creation.  <br>**will help you to mark the document with your own unique id**, by default, the document UUID given by the system.  <br>if you will send the same transaction_id again, we will not create a new doc and instead will give you a link to the original doc |\n| **parent** | String | !DR | parent doc UUID (in case you want to link between 2 documents) |\n| **date** | Date(DD/MM/YYYY) |  | document date, the current date will be applied if not set |\n| **lang** | String |  | `he` for Hebrew doc (this is the default)  <br>`en` for English |\n| **main_currency_iso** | String |  | Default is `ILS`  <br>3 letters of currency ISO (`USD`/`EUR`/`GBP` etc...) |\n| **main_currency_rate** | Integer |  | Default 1 (ILS)  <br>if you would not send this field, the system will calculate the currency base on our rates tables.  <br>If your currency ISO does not exist in our system, sending a rate will be mandatory.  <br>  <br>Polish Zloty (**PLN**) and Czech Koruna(**CZK**) **are not exists in out rates tables.** |\n| **create_org_as_foreign** | Boolean (0/1) |  | Default 0.  <br>use when you have permission to create original documents in English or foreign currency.  <br>Israelis can’t create the original documents in English or not in ILS, so we create a copy and send a translated copy to the customer. |\n| **description** | String |  | Document description |\n| **customer_name** | String | V | Customer name |\n| **customer_email** | String |  | Email address |\n| **customer_crn** | Numeric |  | The customer company number/ID/ etc… (ח.פ. בעברית)  <br>  <br>required by law when document value is greater than 5,000 ILS |\n| **customer_address** | String |  | Customer address |\n| **customer_phone** | String |  | Customer phone |\n| **cc_emails** | Array |  | An array of valid cc emails the document will be sent to.  <br>Limited to 10 emails. |\n| [<b>item</b>](#how-to-add-items) | Array | !R | please refer to item table described below for more details |\n| [<b>payment</b>](#how-to-add-payments) | Array |  | Please refer to payment table described below for more details |\n| **discount_value** | Float | ?R | **the discount_value must be given in a NEGATIVE** value because the `discount_type` is equal to `NUMBER` by default, but if your `discount_type` is equal to `PERCENTAGE` then you must provide a **POSITIVE** value as percentage. |\n| **discount_type** | String |  | `NUMBER` (Default)-  <br>discount_value can be any number between 0 to the sum value and for the value of `PERCENTAGE` - discount_value must be a number between 1 to 100 |\n| **vat** | Float (Positive) | ?R | the document VAT if not supported the current VAT will be used |\n| **price_total** | Float (Positive) | ! | **mandatory in invoice_receipt**, should contain the actual total payments.  <br>can be used to add a discount as total or to validate the data.  <br>, i.e., if the total is 110, and you had set this field as 100, we will recalculate the price so the total will be 100 and move the remaining to VAT and discount fields. |\n| **tax_deduction** | Float (Positive) |  | amount of tax deduction.  <br>should be a positive number in currency (not in percent) relevant only in documents with payments (receipts/invoice receipt etc...) |\n| **pay_until** | Date(DD/MM/YYYY) |  | when this document should be paid |\n| **comment** | String |  | comment inside the document |\n| **email_text** | String |  | email additional text |\n| **dont_send_email** | Boolean (0/1) |  | `0` by default.  <br>when setting a value of `1`, the system will not send an email to the client and will only create a document. |\n| **send_copy** | Boolean (0/1) | ? | send a copy of the document to the owner of the document.  <br>the default value can be controlled from your system settings dashboard. |\n| **print_type** | String |  | `PDF` by default.  <br>if you want this document to be printed only and not created as a PDF or sent by email, use the value `PRINTER`, you will NOT get any links as a response. Your client would have to log in manually into the system and click on “print” to print this document. |\n| **forceItemsIntoNonItemsDocument** | Boolean (0/1) |  | If you want to create a document where the items are not mandatory (like receipt \\\\ donation\\\\ etc...)  <br>**Please add this field in addition to the items array**. |\n| **auto_balance** | Boolean (0/1) |  | In case you are having items & payments, but there is a mismatch between them, we will add a discount to overcome it |\n| **show_items_including_vat** | Boolean (0/1) |  | Show the prices of the items including the VAT.  <br>in order to use this feature וou must send all the items with `vat_type`: `INC`.  <br>This will show the prices including VAT and will not change the calculation in any way |\n| **validate_company_type** | Integer |  | If you want to validate the company type on your behalf between our system, you may add this field, and we will create the document only if the types have a match. |\n| **ua_uuid** | String |  | If you want to create a document on behalf of one of the accounts of the company (in case you have multiple businesses under the same user id) |\n| **customerAction** | String |  | You may relate the document with a customer by the `customer_crn` field,  <br>In order to create/assign document to customer please send `ASSOC_CREATE`  <br>to relate between document to exists customer only send `ASSOC_ONLY` |\n| **c_accounting_num** | String/Number |  | set the Customer accounting number |\n\n> **Document Language:** \n  \n> **Auto balance:** \n  \n\n# How to add items\n\n> **Items list:** \n  \n\n| API KEY | VALUE TYPE | REQUIRED | DESCRIPTION |\n| --- | --- | --- | --- |\n| **catalog_number** | String |  | may be a numeric as well |\n| **details** | String | V | Item name |\n| **amount** | Float | V | Item Quantity |\n| **price** | Float | V | One Item Price |\n| **currency** | String |  | `ILS` by default  <br>**Note:** use `main_currency_iso` instead of this field; it will make your life much easier.  <br>This field is good only when you have multiple currencies. |\n| **currency_rate** | Float |  | currency rate relative to Israeli Shekel.  <br>will be rounded to 4 decimal places.  <br>used only when main_currency_iso is `ILS` |\n| **vat_type** | String |  | **`PRE`** - by default  <br>Price is before VAT  <br>  <br>**`INC`**  <br>Price included VAT  <br>  <br>**`NON`**  <br>The document is a mixed document, and this item is a Non VAT item, please use it only in mixed VAT documents.  <br>  <br>while creating in zero VAT documents just send **`VAT 0`** |\n| **comment** | String |  | an opened text field, used to add extra data regarding the item |\n| **discount_price** | Float |  | If you want to give a discount specific on this line and not on the document, set here a number |\n| **discount_type** | String |  | **`PERCENTAGE`** - `discount_price` must be a number between 1 to 100  <br>**`NUMBER`** - discount_price can be any number between 0 to the sum value of the field |\n\n##### Example of items:\n\n``` json\nforceItemsIntoNonItemsDocument: true,\n  item:[{\n    catalog_number:\"MKT1\",  \n    details:\"1 kg of Internet\",  \n    price:12.44  \n  },{  \n    details:\"infinite amount of love\",  \n    price:99,  \n    vat_type: \"INC\"  \n}]\n\n ```\n\n‏\n\n# How to add payments\n\n> **Note**:  \n`payment` must be an array of payments with the following values below as JSON. \n  \n> **Required explanations:** \n  \n\n!PT\\[X\\] - `X` Represent the Payment type number, e.g: !PT4 - required with payment type 4.  \n?PT\\[X\\] - `X` Represent the payment type number, e.g: ?PT4 - optional with payment type 4.\n\n| API KEY | VALUE TYPE | REQUIRED | DESCRIPTION |\n| --- | --- | --- | --- |\n| **payment_type** | Integer | V | the type of the payment:  <br>`1` - cash  <br>`2` - check  <br>`3` - credit card  <br>`4` - bank transfer  <br>`8` - Direct Debit Bank transfer  <br>`9` - Other  <br>`91` - Web transfer (Pay, Paypal) |\n| **payment_sum** | Decimal | V | The actual payment sum |\n| **date** | Date(DD/MM/YYYY) |  | The date of the payment, can be different from the document date |\n| **comment** | String |  | Comment for the payment, if you want to add the transaction/approval any other data, this is the place |\n| **currency** | String |  | `ILS` by default |\n| **currency_rate** | Float |  | currency rate relative to Israeli Shekel default is `1` |\n| **checks_bank_account** | Any |  | bank account number |\n| **checks_bank_branch** | Any |  | bank branch |\n| **checks_bank_name** | Any | !PT2 | bank name |\n| **checks_number** | Any | !PT2 |  |\n| **bt_bank_account** | Any | ?PT4 / ?PT8 |  |\n| **bt_bank_branch** | Any | ?PT4 / ?PT8 |  |\n| **bt_bank_name** | Any | ?PT4 / ?PT8 |  |\n| **cc_type** | Integer | !PT3 | `0` not in this list  <br>`1` ישראכרט (Isracart)  <br>`2` ויזה (Visa)  <br>`3` דיינרס (Diners)  <br>`4` אמריקן אקספרס(American express)  <br>`6` לאומי קארד (Leumi card)  <br>`99` מאסטרקארד (Mastercard) |\n| **cc_type_name** | String | !PT3 | the name of the credit card |\n| **cc_number** | Numeric | !PT3 | **last 4 digits** |\n| **cc_deal_type** | Integer | !PT3 | `1` רגיל (Normal)  <br>`2` תשלומים (Payments)  <br>`3` קרדיט (Credit)  <br>`4` חיוב נדחה (Delayed)  <br>`5` אחר (other) |\n| **cc_num_of_payments** | Integer | !PT3 | how many payment total for this CC |\n| **auto_calc_payments** | Boolean (0/1) |  | **Wizard**  <br>If you’ll send this parameter you won’t need to set line for each payment, and we will calculate the payments, and the future dates for you  <br>  <br>**Important: please read the footnote** |\n| **cc_payment_num** | Integer | !PT3 | this is paymemt N / payments, if not supplied or set to 0 you will got  <br>תשלומים:cc_num_of_payments  <br>instead of תשלום cc_payment_num / cc_num_of_payments |\n| **wt_vendor** | String |  | **The name of the vendor**. |\n| **wt_transaction_id** | String |  | Web transfer transaction id |\n| **wt_payer_account** | String |  | Web transfer payer account id |\n| **other_payment_type_name** | String | !PT9 | Payment of type other - name |\n| **auto_invoice_status** | Boolean (0/1) |  | Automatic creation of invoice for this payment when the payment date is arrive.  <br>**Relevant only for VAT users, and on doc type receipt (400) with future cheques or cc payments>1** |\n| **auto_invoice_description** | String |  | Required when using the `auto_invoice_status`.  <br>This is the item for the automatic invoice, without it, the creation will be failed. |\n\n> **Auto calc payments**: \n  \n\n##### Example of payments:\n\n``` js\npayment:[{\n    payment_type:\"1\",\n    date:\"10/10/2010\",\n    payment_sum: 250,\n  },{\n    payment_type:3,\n    date:\"10/10/2010\",\n    payment: 250,\n    cc_type: 0,\n    cc_type_name: \"ויזה\" \n}]\n\n ```\n\n## Catch error messages\n\nThe API will return an object that includes the error number with the message related to the specific error number and a `status` key of boolean type equal to `FALSE`.\n\n#### Example of error response:\n\n``` js\n{\n    \"success\": false,\n    \"errNum\": 1,\n    \"errMsg\": \"api key is malformatted\"\n}\n\n ```\n\n## Success messages\n\nEvery successful response contain an object with the key `status`, which is a boolean type and equal to `TRUE`\n\n#### Example of success response:\n\n``` js\n{\n    \"pdf_link\": \"https://demo.ezcount.co.il/front/documents/get/0f2a3f82-afe0-41e9-8235-adb5f17bdfb6\",\n    \"pdf_link_copy\": \"https://demo.ezcount.co.il/front/documents/get/0f2a3f82-afe0-41e9-8235-adb5f17bdfb6/copy\",\n    \"doc_number\": \"60002\",\n    \"doc_uuid\": \"0f2a3f82-afe0-41e9-8235-adb5f17bdfb6\",\n    \"sent_mails\": [\n        \"demo@example.com\"\n    ],\n    \"success\": true\n}\n\n ```\n\n- **pdf_link** - link to the original document, this link has been sent to the client if - --- ordered to.\n    \n- **pdf_link_copy** - the copy document (`העתק נאמן למקור`)\n    \n- **doc_number** - the document number.\n    \n- **doc_uuid** - each document in the system has a unique id.\n    \n- **sent_mails** - the emails this document been sent to\n    \n\n# **Tax Authority**\n\nYou can control the Tax Authority's common solution for edge cases.  \nIn order to control the Tax Authority during the document creation process, you must call the API with the following `tax_authority` object properties:\n\n| API KEY | VALUE TYPE | REQUIRED | DESCRIPTION |\n| --- | --- | --- | --- |\n| **is_skip_fallback** | Boolean |  | Create the document, as a fallback, regardless of the issue related to the Tax Authority  <br>**\\*‏\\*Warning**:** be aware that by using that option, you agree to a document creation without the Tax Authority approval |\n| **is_anonymous_fallback** | Boolean |  | We will send to the Tax Authority an anonymous identifier in case of a missing customer CRN |\n| **is_foreign_fallback** | Boolean |  | We will send to the Tax Authority a foreign identifier in case of a non-Israeli customer, in the CRN format |\n\nPayload body e.g:\n\n``` json\n{\n  \"developer_email\": \"{{DEVELOPER_EMAIL}}\",\n  \"api_key\": \"{{API_KEY}}\",\n  \"tax_authority\": {\n    \"is_skip_fallback\": false,\n    \"is_anonymous_fallback\": false,\n    \"is_foreign_fallback\": false\n  }\n}\n\n ```\n\n#### Common Tax Authority issues after document creation\n\n- When the document is waiting for the Tax Authority allocation number, we will return the status `417`.\n    \n- To receive the relevant Tax Authority error, you can view it from our documents dashboard interface or set up and listen to the Tax Authority webhook.\n    \n- When the document is not accessible and the status code is `417` You need to use the four options:\n    \n    - [Skip the Tax Authority allocation number](#c30471b0-db04-46e3-98cf-0db5fcc32091)\n        \n    - [Cancel the documents.](#d02a0eea-46a2-4dd1-b964-6f795095ae7a)\n        \n    - [Further objection of Tax Authority](#dfc6f4ab-9dd4-42f8-965c-350f093f2ce3)\n        \n    - [Reverse Tax](#a5f5e3f1-38a7-4031-80b3-dfe41a727544) - Cancel the invoice and initiate a document with **zero percent VAT**.  \n        The end customer needs to create a self-invoice document.\n        \n    - **Optional:** set your own Tax Authority allocation number\n        \n- **Important notice for distributors:** When the request status code is `417` and the error code is `460` While accessing the document via API request, You need to return to the document creator the Tax Authority message:\n    \n\n_להלן התגובה של רשות המסים:_  \nהריני להודיעך כי מבדיקה שנערכה ביחס לבקשתך לקבל מספר הקצאה לחשבונית המס,  \nבשלב זה, לא ניתן מספר הקצאה לחשבונית מאחר וקיים חשש כי מדובר בחשבונית שהוצאה שלא כדין, בין היתר מהטעם שמוציא החשבונית אינו מי שהוסמך להוציאה ו/או מדובר בעסקה חריגה ו/או אחד מהפרטים שהוזנו לגבי החשבונית אינו משקף את פרטי העסקה ו/או אינו נכון.\n\n# Debugging tools\n\nin order to debug your code, we had built some quick tools:\n\n1. use the [https://demo.ezcount.co.il](https://demo.ezcount.co.il) to create some documents from the UI, our UI uses the API, so you will understand easily and more intuitive the API full features.\n    \n2. check how the server sees your request:  \n    a. when you are sending a request, add the `debug_key` parameter with any value you wish to the request URL:  \n    [https://demo.ezcount.co.il/api/createDoc?debug_key=A1B2C3](https://demo.ezcount.co.il/api/createDoc?debug_key=A1B2C3) for example  \n    b. after the request been sent go to  \n    [https://demo.ezcount.co.il/api/getLastAPIRequestData?debug_key=A1B2C3&amp;api_key=[YOUR_API_KEY]&amp;developer_email=[YOUR@EMAIL.COM]](https://demo.ezcount.co.il/api/getLastAPIRequestData?debug_key=A1B2C3&api_key=%5BYOUR_API_KEY%5D&developer_email=%5BYOUR@EMAIL.COM%5D)  \n    here you will get a dump of what the server get:\n    \n\n**POST** - the POST array\n\n**RAWDATA** - the RAW data, this is used mainly when you send a JSON request\n\n**REQUEST_HEADERS** - the request headers as the server see them\n\n# Advanced API methods\n\nThe methods described here are more advanced and are not part of our code samples and SDK’s, but we do maintain them.\n\nCreating doc on behalf of another account under the business\n\n### How to use it:\n\nIt is possible to create a document on behalf of one of the accounts of the company (in case you have multiple businesses under the same user id)\n\n1. Create another business and set the invoice details for this business\n    \n2. Now go to this address https://\\[demo\\\\www\\].ezcount.co.il/backoffice/accounts\n    \n3. Edit the account, and you will see a UUID number at the bottom of the modal\n    \n4. Add the next field to the root of the JSON: `ua_uuid: XXXX-XXXX-XXXX-XXXXXXXX`\n    \n5. Now the invoice will be created with the details of the specific account, you may send `ua_uuid: null` if you want to send it on behalf of the main account.\n    \n\n> **Common errors**: \n  \n\n# Going to production\n\nIn order to start using the production environment please follow the next steps:\n\n1. Create an account in production and fetch the `api_key` for this account. [https://www.ezcount.co.il/EZcountApp.html#/settings/tab_api](https://www.ezcount.co.il/EZcountApp.html#/settings/tab_api)\n    \n2. If you are sending docs on behalf of other EZcount users who are not you, please add a created_by_api_key field and set there your account api_key.\n    \n3. Set your API endpoint requests to **`{{API_BASE_URL}}`** instead of `{{DEMO_BASE_URL}}`\n    \n4. Please - make sure your timeout settings are set correctly on your production environment, please set your timeout to be at least 30sec.\n    \n5. Send your API requests to `{{API_BASE_URL}}`","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"16363118","team":2101499,"collectionId":"9e179f6d-6503-4fcc-8959-04a411028efc","publishedId":"TzkyNLWB","public":true,"publicUrl":"https://documenter-api.postman.tech/view/16363118/TzkyNLWB","privateUrl":"https://go.postman.co/documentation/16363118-9e179f6d-6503-4fcc-8959-04a411028efc","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2021-07-18T13:29:51.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"Staging","id":"1e88e434-b13f-4e7c-8ed1-eff6e11e5d88","owner":"16363118","values":[{"key":"DEMO_BASE_URL","value":"https://demo.ezcount.co.il","enabled":true},{"key":"API_BASE_URL","value":"https://api.ezcount.co.il","enabled":true},{"key":"API_KEY","value":"[-- YOUR API KEY --]","enabled":true},{"key":"DEVELOPER_EMAIL","value":"[-- EMAIL ADDRESS --]","enabled":true},{"key":"ACCESS_TOKEN","value":"1420a2e02f6b22559089761371491f5f4a8a4e9a","enabled":true},{"key":"REFRESH_TOKEN","value":"91aff21e819627fc9cf84d5e657903a154d88eec","enabled":true},{"key":"OAUTH2_FIRSTCODE","value":"b7b6bdccf58792ce3fd754ab307d369d1597b6f1","enabled":true},{"key":"ENV_BASE_URL","value":"https://demo.ezcount.co.il","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/91c2390d157f08b0b9196e8706d08bdb714262459e57aadda9ac542b77a0463e","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Staging","value":"16363118-1e88e434-b13f-4e7c-8ed1-eff6e11e5d88"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/TzkyNLWB"}