> For the complete documentation index, see [llms.txt](https://invoice4u.gitbook.io/invoice4u-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://invoice4u.gitbook.io/invoice4u-docs/he/documents/search-documents.md).

# חיפוש מסמכים

‫חיפוש מסמכים מסונן על פני הארגון המאומת.‬

## ‫מתודה‬

|             |                                                                           |
| ----------- | ------------------------------------------------------------------------- |
| ‫**מתודה**‬ | `POST`                                                                    |
| ‫**נתיב**‬  | `/GetDocuments`                                                           |
| ‫**תשובה**‬ | `CommonCollection<Document[]>` — ‏`{ "Response": [ ... ], "Errors": [] }` |

## ‫סכימת הבקשה — `dr` (DocumentsRequest)‬

| ‫שדה‬                                             | ‫טיפוס‬       | ‫חובה‬ | ‫תיאור‬                                                                      |
| ------------------------------------------------- | ------------- | ------ | ---------------------------------------------------------------------------- |
| `DocumentType`                                    | int           | ‫כן    | ‫סינון לפי [סוג מסמך](/invoice4u-docs/he/documents/document-types.md) בודד.‬ |
| `From` / `To`                                     | datetime      | ‫לא‬   | ‫טווח תאריכי הפקה.‬                                                          |
| `FromActualCreationDate` / `ToActualCreationDate` | datetime      | ‫לא‬   | ‫טווח תאריכי יצירה בפועל.‬                                                   |
| `FromPaymentDueDate` / `ToPaymentDueDate`         | datetime      | ‫לא‬   | ‫טווח תאריכי פירעון.‬                                                        |
| `Status`                                          | int           | ‫לא‬   | ‫[סטטוס מסמך](/invoice4u-docs/he/documents/document-types.md#statusid).‬     |
| `CustomerID`                                      | int           | ‫לא‬   | ‫סינון לפי לקוח.‬                                                            |
| `CustomerName`                                    | string        | ‫לא‬   | ‫סינון לפי שם לקוח (חייב להתקיים — אחרת `ClientDoesntExists`, 7).‬           |
| `BranchID`                                        | int           | ‫לא‬   | ‫סינון לפי סניף.‬                                                            |
| `DocumentNumber` / `ExectDocumentNumber`          | int           | ‫לא‬   | ‫תחילית מספר / מספר מדויק.‬                                                  |
| `FromNumber` / `ToNumber`                         | int           | ‫לא‬   | ‫טווח מספרי מסמכים.‬                                                         |
| `FromAmount` / `ToAmount`                         | float         | ‫לא‬   | ‫טווח סכום כולל.‬                                                            |
| `Currency`                                        | string        | ‫לא‬   | ‫סינון מטבע.‬                                                                |
| `PaymentType`                                     | int           | ‫לא‬   | ‫סינון קבלות לפי סוג תשלום.‬                                                 |
| `ItemCode` / `ItemDescription`                    | string        | ‫לא‬   | ‫סינון לפי שדות פריט.‬                                                       |
| `ItemsIncluded`                                   | boolean       | ‫לא‬   | ‫כלילת `Items` מלאים בתוצאות.‬                                               |
| `PaymentsIncluded`                                | boolean       | ‫לא‬   | ‫כלילת `Payments` מלאים בתוצאות.‬                                            |
| `OnlyGeneralClient` / `GeneralClientName`         | bool / string | ‫לא‬   | ‫סינוני לקוח מזדמן.‬                                                         |

## ‫דוגמת בקשה‬

```http
POST /Services/ApiService.svc/GetDocuments HTTP/1.1
Host: apiqa.invoice4u.co.il
Content-Type: application/json

{
  "dr": {
    "DocumentType": 3,
    "From": "2026-06-01T00:00:00",
    "To": "2026-06-30T23:59:59",
    "CustomerID": 88231,
    "ItemsIncluded": true
  },
  "token": "<token>"
}
```

## ‫דוגמת תשובה‬

```json
{
  "GetDocumentsResult": {
    "Response": [
      { "ID": "7f6a2c1e-...", "DocumentNumber": 20260123, "Total": 117.0 },
      { "ID": "8a7b3d2f-...", "DocumentNumber": 20260124, "Total": 234.0 }
    ],
    "Errors": []
  }
}
```

## ‫שגיאות‬

| ‫שגיאה (ID)‬             | ‫משמעות‬                               |
| ------------------------ | -------------------------------------- |
| `UnauthorizedUser` (80)  | ‫טוקן לא תקין.‬                        |
| `ClientDoesntExists` (7) | ‫פילטר `CustomerName` לא התאים ללקוח.‬ |

{% hint style="info" %}
‫המתודה מחזירה **סוג מסמך אחד בלבד לקריאה** — `DocumentType` מקבל ערך יחיד ולא רשימה. כדי לחפש כמה סוגים, בצעו קריאה נפרדת לכל סוג ואחדו את התוצאות בצד הלקוח.‬
{% endhint %}

{% hint style="info" %}
‫שולפים מסמך אחד ידוע? השתמשו ב[שליפות מסמך בודד](/invoice4u-docs/he/documents/get-document.md) — מהיר ופשוט יותר.‬
{% endhint %}

## ‫נסו את זה‬

## POST /GetDocuments

> Search documents

```json
{"openapi":"3.0.3","info":{"title":"Invoice4U API","version":"1.0.0"},"tags":[{"name":"Documents","description":"Create and retrieve documents (invoices, receipts, etc.)."}],"servers":[{"url":"https://api.invoice4u.co.il/Services/ApiService.svc","description":"Production"},{"url":"https://apiqa.invoice4u.co.il/Services/ApiService.svc","description":"QA (staging)"}],"paths":{"/GetDocuments":{"post":{"tags":["Documents"],"operationId":"GetDocuments","summary":"Search documents","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["dr","token"],"properties":{"dr":{"$ref":"#/components/schemas/DocumentsRequest"},"token":{"type":"string"}}}}}},"responses":{"200":{"description":"Matching documents.","content":{"application/json":{"schema":{"type":"object","properties":{"GetDocumentsResult":{"$ref":"#/components/schemas/DocumentCollection"}}}}}}}}}},"components":{"schemas":{"DocumentsRequest":{"type":"object","required":["DocumentType"],"properties":{"DocumentType":{"type":"integer","description":"Single document type filter."},"DocumentTypes":{"type":"string","nullable":true,"description":"Comma-separated list of types."},"From":{"type":"string","format":"date-time","nullable":true},"To":{"type":"string","format":"date-time","nullable":true},"FromActualCreationDate":{"type":"string","format":"date-time","nullable":true},"ToActualCreationDate":{"type":"string","format":"date-time","nullable":true},"FromPaymentDueDate":{"type":"string","format":"date-time","nullable":true},"ToPaymentDueDate":{"type":"string","format":"date-time","nullable":true},"Status":{"type":"integer","description":"Document status filter."},"CustomerID":{"type":"integer","nullable":true},"CustomerName":{"type":"string","nullable":true},"BranchID":{"type":"integer"},"DocumentNumber":{"type":"integer"},"ExectDocumentNumber":{"type":"integer","description":"Exact document number."},"FromNumber":{"type":"integer","nullable":true},"ToNumber":{"type":"integer","nullable":true},"FromAmount":{"type":"number","format":"float","nullable":true},"ToAmount":{"type":"number","format":"float","nullable":true},"Currency":{"type":"string","nullable":true},"PaymentType":{"type":"integer"},"ItemCode":{"type":"string","nullable":true},"ItemDescription":{"type":"string","nullable":true},"ItemsIncluded":{"type":"boolean","nullable":true,"description":"Include full Items in results."},"PaymentsIncluded":{"type":"boolean","nullable":true,"description":"Include full Payments in results."},"OnlyGeneralClient":{"type":"boolean","nullable":true},"GeneralClientName":{"type":"string","nullable":true}}},"DocumentCollection":{"allOf":[{"$ref":"#/components/schemas/CommonObject"},{"type":"object","properties":{"Response":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/Document"}}}}]},"CommonObject":{"type":"object","description":"Response envelope inherited by most objects. Server-generated — never send these fields in requests. Always check Errors before using the payload.","properties":{"Errors":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CommonError"}},"Info":{"type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CommonInfo"}},"OpenInfo":{"type":"object","readOnly":true,"additionalProperties":{"type":"string"},"nullable":true}}},"CommonError":{"type":"object","properties":{"ID":{"type":"integer","description":"Numeric error code, e.g. 80 = UnauthorizedUser, 134 = DocumentAlreadyCreated."},"Error":{"type":"string","description":"Error name."},"Paramters":{"type":"string","nullable":true,"description":"Optional context, e.g. \"Row Number - 0\"."}}},"CommonInfo":{"type":"object","properties":{"ID":{"type":"integer"},"Info":{"type":"string"},"Paramters":{"type":"string","nullable":true}}},"Document":{"allOf":[{"$ref":"#/components/schemas/CommonObject"},{"type":"object","required":["DocumentType"],"properties":{"ID":{"type":"string","format":"uuid","readOnly":true},"DocumentNumber":{"type":"integer","format":"int64","readOnly":true,"description":"Legal sequential number, per type."},"DocumentType":{"type":"integer","description":"1 Invoice, 2 Receipt, 3 InvoiceReceipt, 4 InvoiceCredit, 5 ProformaInvoice, 6 InvoiceOrder, 7 InvoiceQuote, 8 InvoiceShip, 9 Deposits, 10 SupplierInvoiceToInventory, 13 PurchaseOrder.","enum":[1,2,3,4,5,6,7,8,9,10,13]},"Subject":{"type":"string","nullable":true},"ClientID":{"type":"integer","nullable":true,"description":"Existing customer ID. Required unless GeneralCustomer is supplied or the type doesn't need a customer."},"GeneralCustomer":{"$ref":"#/components/schemas/GenerelCustomer"},"Items":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/DocumentItem"}},"Payments":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/Payment"}},"Invoices":{"type":"array","nullable":true,"description":"Referenced documents (each with ID and ReceiptAmount). Requires DocumentReffType.","items":{"type":"object","properties":{"ID":{"type":"string","format":"uuid"},"ReceiptAmount":{"type":"number","format":"double"}}}},"DocumentReffType":{"type":"integer","description":"Type of the referenced documents."},"IssueDate":{"type":"string","format":"date-time","nullable":true,"description":"Defaults to today. Not in the future; not before your latest document of the type."},"Currency":{"type":"string","nullable":true},"ConversionRate":{"type":"number","format":"double","description":"Auto-resolved when 0."},"TaxPercentage":{"type":"number","format":"double","nullable":true},"TaxIncluded":{"type":"boolean","description":"Whether item prices include VAT."},"Discount":{"$ref":"#/components/schemas/Discount"},"BranchID":{"type":"integer","nullable":true,"description":"Defaults to the organization's default branch."},"Language":{"type":"integer","description":"1 Hebrew, 2 English."},"AssociatedEmails":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/AssociatedEmail"}},"ExternalComments":{"type":"string","nullable":true,"maxLength":5000},"InternalComments":{"type":"string","nullable":true},"EmailCustomComment":{"type":"string","nullable":true},"ApiIdentifier":{"type":"string","nullable":true,"description":"Idempotency key. Auto-generated if missing."},"ApiDuplicityTimeValidation":{"type":"integer","description":"Duplicate-detection window in seconds. Default 60."},"PaymentDueDate":{"type":"string","format":"date-time","nullable":true},"Deduction":{"type":"number","format":"double","description":"Withholding-tax deduction (receipts)."},"CloseReceipt":{"type":"boolean"},"IsSelfInvoice":{"type":"boolean"},"SupplierId":{"type":"integer","nullable":true},"SupplierName":{"type":"string","nullable":true},"UseDecimalValues":{"type":"boolean"},"AutoFixPaymentsMismatchItems":{"type":"boolean","description":"Auto-fix ±0.01 rounding gaps between payments and items."},"AutoFixMismatchItemName":{"type":"string","nullable":true},"Total":{"type":"number","format":"double","readOnly":true},"TotalWithoutTax":{"type":"number","format":"double","readOnly":true},"TotalTaxAmount":{"type":"number","format":"double","readOnly":true},"StatusID":{"type":"integer","readOnly":true,"description":"1 Open, 2 Closed, 3 FullyCredited, 4 PartiallyCredited, 5 Cancelled."},"PrintOriginalPDFLink":{"type":"string","readOnly":true},"PrintCertifiedCopyPDFLink":{"type":"string","readOnly":true},"CipherText":{"type":"string","readOnly":true},"CipherTextOriginal":{"type":"string","readOnly":true},"AllocationNumber":{"type":"string","nullable":true,"readOnly":true},"Paid":{"type":"number","format":"double","readOnly":true},"CreditAmount":{"type":"number","format":"double","readOnly":true},"Balance":{"type":"number","format":"double","readOnly":true}}}]},"GenerelCustomer":{"type":"object","required":["Name"],"description":"One-off (general) customer for documents without a stored customer record.","properties":{"ID":{"type":"integer"},"Name":{"type":"string"},"Identifier":{"type":"string","description":"VAT/ID number."}}},"DocumentItem":{"type":"object","required":["Name","Quantity","Price"],"properties":{"Name":{"type":"string"},"Description":{"type":"string","nullable":true},"Price":{"type":"number","format":"double","description":"Unit price."},"PriceIncludeTax":{"type":"number","format":"double","description":"Price including VAT (when TaxIncluded)."},"Quantity":{"type":"number","format":"double"},"TaxPercentage":{"type":"number","format":"double","nullable":true,"description":"Per-item VAT override."},"Discount":{"$ref":"#/components/schemas/Discount"},"Code":{"type":"string","nullable":true,"description":"Catalog code."},"LawyerIdentifier":{"type":"string","nullable":true,"description":"Lawyer accounts: \"1\" deposits, \"2\" expenses."},"InventoryId":{"type":"integer","nullable":true},"WarehouseId":{"type":"integer","nullable":true},"Total":{"type":"number","format":"double","readOnly":true},"TotalWithoutTax":{"type":"number","format":"double","readOnly":true},"TotalTax":{"type":"number","format":"double","readOnly":true}}},"Discount":{"type":"object","required":["Value"],"properties":{"Value":{"type":"number","format":"double"},"IsNominal":{"type":"boolean","description":"true = fixed amount, false = percent."},"BeforeTax":{"type":"boolean"}}},"Payment":{"type":"object","required":["PaymentType","Amount"],"properties":{"ID":{"type":"integer","description":"Existing payment ID — used for Deposits documents."},"PaymentType":{"type":"integer","description":"1 CreditCard, 2 Check, 3 MoneyTransfer, 4 Cash, 5 Credit, 6 WithholdingTax, 7 Other, 8 Bit, 9 PayBox.","enum":[1,2,3,4,5,6,7,8,9]},"Amount":{"type":"number","format":"double"},"Date":{"type":"string","format":"date-time","nullable":true},"DateStr":{"type":"string","nullable":true,"description":"Alternative string date when Date is not set."},"NumberOfPayments":{"type":"integer","description":"Credit-card installments."},"CreditCardName":{"type":"string","nullable":true,"description":"Card brand name; resolved against configured credit companies."},"CreditCardType":{"type":"integer","nullable":true},"PaymentNumber":{"type":"string","nullable":true,"description":"Check number / last 4 card digits."},"BankName":{"type":"string","nullable":true},"BranchName":{"type":"string","nullable":true},"AccountNumber":{"type":"string","nullable":true},"PayerID":{"type":"string","nullable":true},"ExpirationDate":{"type":"string","nullable":true},"PaymentTypeOtherId":{"type":"integer","description":"Sub-type when PaymentType=7 (Other)."},"PaymentTypeLiteral":{"type":"string","nullable":true}}},"AssociatedEmail":{"type":"object","required":["Mail"],"properties":{"Mail":{"type":"string","format":"email"},"IsUserMail":{"type":"boolean","description":"true marks the copy sent to the account owner."},"ClientId":{"type":"integer","nullable":true},"IsSendDoc":{"type":"boolean","nullable":true}}}}}}
```