Appearance
Receipts API
The Receipts API provides endpoints to get receipts.
Get Receipts (JSON)
Endpoint:
GET /{companyId}/receipts/jsonQuery Parameters:
start_date(optional) - Filter receipts from this date.end_date(optional) - Filter receipts up to this date.order_by(optional, default:created_at) - Sorting field.order_direction(optional, default:desc) - Sorting order.
Example Request:
sh
curl -X GET "https://app.masrapp.net/integration/v1/{companyId}/receipts/json" \
-H "X-API-KEY: your_api_key"Example Response:
json
{
"data": [
{
"id": "9e43df63-09da-4174-9fc2-aa78db03e5e3",
"owner": {
"id": "9e35f6ab-bd06-4ca1-9c7d-1c01e41b2551",
"name": "Employee User",
"email": "employee@orneksirket.com"
},
"receipt_date": "2025-02-17 00:00:00",
"receipt_number": "",
"vendor_id": "9e43df63-0894-4569-a07e-b0ba86a7aafd",
"vendor": {
"id": "9e43df63-0894-4569-a07e-b0ba86a7aafd",
"code": null,
"name": "BIM BiRLESiK MAGAZALAR A.S.",
"creator": null,
"created_at": "2025-02-21T13:11:18.000000Z"
},
"budget_id": "",
"budget": null,
"items": [
{
"id": "9e43df63-0ce9-4e7f-9005-3bc6f2847a89",
"category": {
"id": "9e35ec37-b08c-462f-9207-207682b87f5b",
"code": "PAZ01",
"name": "Pazarlama ve Reklam",
"status": 1,
"created_at": "2025-02-14T14:45:35.000000Z"
},
"tax_rate": {
"id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
"name": "%1 KDV",
"rate": 1
},
"description": "TAZE KASAR 700G",
"total": 215,
"tax": 2.13,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-0e65-467c-b37c-4fb17cc19800",
"category": {
"id": "9e35ec37-b08c-462f-9207-207682b87f5b",
"code": "PAZ01",
"name": "Pazarlama ve Reklam",
"status": 1,
"created_at": "2025-02-14T14:45:35.000000Z"
},
"tax_rate": {
"id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
"name": "%1 KDV",
"rate": 1
},
"description": "SEKER KUP 1KG",
"total": 44.5,
"tax": 0.44,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-0fab-4cbd-97c4-1500b602a650",
"category": {
"id": "9e35ec37-b08c-462f-9207-207682b87f5b",
"code": "PAZ01",
"name": "Pazarlama ve Reklam",
"status": 1,
"created_at": "2025-02-14T14:45:35.000000Z"
},
"tax_rate": {
"id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
"name": "%1 KDV",
"rate": 1
},
"description": "DOMATES SALCASI 830G",
"total": 38,
"tax": 0.38,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-10a0-4292-83c2-56f92f2832e6",
"category": {
"id": "9e35ec37-b08c-462f-9207-207682b87f5b",
"code": "PAZ01",
"name": "Pazarlama ve Reklam",
"status": 1,
"created_at": "2025-02-14T14:45:35.000000Z"
},
"tax_rate": {
"id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
"name": "%1 KDV",
"rate": 1
},
"description": "BALDO PiRiNC 2,5KG",
"total": 172.5,
"tax": 1.71,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-114d-4dab-a131-ec2dc6e46cb9",
"category": {
"id": "9e35ec37-b08c-462f-9207-207682b87f5b",
"code": "PAZ01",
"name": "Pazarlama ve Reklam",
"status": 1,
"created_at": "2025-02-14T14:45:35.000000Z"
},
"tax_rate": {
"id": "9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba",
"name": "%1 KDV",
"rate": 1
},
"description": "MERCIMEK YESiL 1 KG",
"total": 59.75,
"tax": 0.59,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-0b98-4db2-9df6-4c753f75fc75",
"category": {
"id": "9e35ec4e-155c-45e4-9712-30d922bb8c6a",
"code": "OF01",
"name": "Ofis ve İşletme Giderleri",
"status": 1,
"created_at": "2025-02-14T14:45:49.000000Z"
},
"tax_rate": {
"id": "9e35e60a-bb7b-4cb3-b470-4ee789dde7aa",
"name": "%20 KDV",
"rate": 20
},
"description": "TUVALET KAGIDI 12Li",
"total": 109.75,
"tax": 18.29,
"created_at": "2025-02-21T13:11:18.000000Z"
},
{
"id": "9e43df63-1247-44be-ac4f-543fd2d32ace",
"category": {
"id": "9e35ec4e-155c-45e4-9712-30d922bb8c6a",
"code": "OF01",
"name": "Ofis ve İşletme Giderleri",
"status": 1,
"created_at": "2025-02-14T14:45:49.000000Z"
},
"tax_rate": {
"id": "9e35e60a-bb7b-4cb3-b470-4ee789dde7aa",
"name": "%20 KDV",
"rate": 20
},
"description": "ALISVER1$ POSETI BIM",
"total": 0.5,
"tax": 0.08,
"created_at": "2025-02-21T13:11:18.000000Z"
}
],
"manager_response": 0,
"manager_response_note": null,
"finance_manager_response": 0,
"finance_manager_response_note": null,
"total": 640,
"tax": 23.62,
"created_at": "2025-02-21T13:11:18.000000Z"
}
],
"links": {
"first": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
"last": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "\" Öncesi",
"active": false
},
{
"url": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Sonraki \"",
"active": false
}
],
"path": "https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/json",
"per_page": 50,
"to": 1,
"total": 1
}
}Get Receipts (XML)
Endpoint:
GET /{companyId}/receipts/xmlExample Request:
sh
curl -X GET "https://app.masrapp.net/integration/v1/{companyId}/receipts/xml" \
-H "X-API-KEY: your_api_key"Example Response:
xml
<?xml version="1.0" encoding="utf-8"?>
<root>
<data>
<receipt>
<id>9e43df63-09da-4174-9fc2-aa78db03e5e3</id>
<owner>
<id>9e35f6ab-bd06-4ca1-9c7d-1c01e41b2551</id>
<name>Employee User</name>
<email>employee@orneksirket.com</email>
</owner>
<receipt_date>2025-02-17 00:00:00</receipt_date>
<receipt_number></receipt_number>
<vendor_id>9e43df63-0894-4569-a07e-b0ba86a7aafd</vendor_id>
<vendor>
<id>9e43df63-0894-4569-a07e-b0ba86a7aafd</id>
<code></code>
<name>BIM BiRLESiK MAGAZALAR A.S.</name>
<creator></creator>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</vendor>
<budget_id></budget_id>
<budget></budget>
<items>
<item>
<id>9e43df63-0ce9-4e7f-9005-3bc6f2847a89</id>
<category>
<id>9e35ec37-b08c-462f-9207-207682b87f5b</id>
<code>PAZ01</code>
<name>Pazarlama ve Reklam</name>
<status>1</status>
<created_at>2025-02-14T14:45:35.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba</id>
<name>%1 KDV</name>
<rate>1</rate>
</tax_rate>
<description>TAZE KASAR 700G</description>
<total>215</total>
<tax>2.13</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-0e65-467c-b37c-4fb17cc19800</id>
<category>
<id>9e35ec37-b08c-462f-9207-207682b87f5b</id>
<code>PAZ01</code>
<name>Pazarlama ve Reklam</name>
<status>1</status>
<created_at>2025-02-14T14:45:35.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba</id>
<name>%1 KDV</name>
<rate>1</rate>
</tax_rate>
<description>SEKER KUP 1KG</description>
<total>44.5</total>
<tax>0.44</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-0fab-4cbd-97c4-1500b602a650</id>
<category>
<id>9e35ec37-b08c-462f-9207-207682b87f5b</id>
<code>PAZ01</code>
<name>Pazarlama ve Reklam</name>
<status>1</status>
<created_at>2025-02-14T14:45:35.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba</id>
<name>%1 KDV</name>
<rate>1</rate>
</tax_rate>
<description>DOMATES SALCASI 830G</description>
<total>38</total>
<tax>0.38</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-10a0-4292-83c2-56f92f2832e6</id>
<category>
<id>9e35ec37-b08c-462f-9207-207682b87f5b</id>
<code>PAZ01</code>
<name>Pazarlama ve Reklam</name>
<status>1</status>
<created_at>2025-02-14T14:45:35.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba</id>
<name>%1 KDV</name>
<rate>1</rate>
</tax_rate>
<description>BALDO PiRiNC 2,5KG</description>
<total>172.5</total>
<tax>1.71</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-114d-4dab-a131-ec2dc6e46cb9</id>
<category>
<id>9e35ec37-b08c-462f-9207-207682b87f5b</id>
<code>PAZ01</code>
<name>Pazarlama ve Reklam</name>
<status>1</status>
<created_at>2025-02-14T14:45:35.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-b5d6-41d9-a20b-4a5ec3fcf3ba</id>
<name>%1 KDV</name>
<rate>1</rate>
</tax_rate>
<description>MERCIMEK YESiL 1 KG</description>
<total>59.75</total>
<tax>0.59</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-0b98-4db2-9df6-4c753f75fc75</id>
<category>
<id>9e35ec4e-155c-45e4-9712-30d922bb8c6a</id>
<code>OF01</code>
<name>Ofis ve İşletme Giderleri</name>
<status>1</status>
<created_at>2025-02-14T14:45:49.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-bb7b-4cb3-b470-4ee789dde7aa</id>
<name>%20 KDV</name>
<rate>20</rate>
</tax_rate>
<description>TUVALET KAGIDI 12Li</description>
<total>109.75</total>
<tax>18.29</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
<item>
<id>9e43df63-1247-44be-ac4f-543fd2d32ace</id>
<category>
<id>9e35ec4e-155c-45e4-9712-30d922bb8c6a</id>
<code>OF01</code>
<name>Ofis ve İşletme Giderleri</name>
<status>1</status>
<created_at>2025-02-14T14:45:49.000000Z</created_at>
</category>
<tax_rate>
<id>9e35e60a-bb7b-4cb3-b470-4ee789dde7aa</id>
<name>%20 KDV</name>
<rate>20</rate>
</tax_rate>
<description>ALISVER1$ POSETI BIM</description>
<total>0.5</total>
<tax>0.08</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</item>
</items>
<manager_response>0</manager_response>
<manager_response_note></manager_response_note>
<finance_manager_response>0</finance_manager_response>
<finance_manager_response_note></finance_manager_response_note>
<total>640</total>
<tax>23.62</tax>
<created_at>2025-02-21T13:11:18.000000Z</created_at>
</receipt>
</data>
<links>
<first>https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/xml?page=1</first>
<last>https://app.masrapp.net/integration/v1/9e35e991-b733-4a65-9e2f-152adf94a013/receipts/xml?page=1</last>
<prev></prev>
<next></next>
</links>
<meta>
<current_page>1</current_page>
<from>1</from>
<last_page>1</last_page>
<per_page>50</per_page>
<to>1</to>
<total>1</total>
</meta>
</root>