Ristivo API

curl -X GET https://ristivo.com/api/v1/business \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "id": "biz_3f9a1c07d2e4b658",
  "name": "Örnek Lokanta",
  "address": "Kemalpaşa Mah. Çarşı Cad. No:12, Çanakkale",
  "phone": "+90 286 000 00 00",
  "timezone": "Europe/Istanbul",
  "currency": "TRY",
  "modules": [
    "pos",
    "reservation",
    "customers"
  ],
  "connection": {
    "type": "partner",
    "scopes": [
      "business:read",
      "delivery:read",
      "delivery:write"
    ],
    "created_at": "2026-10-26T14:05:00+03:00"
  }
}

curl -X GET https://ristivo.com/api/v1/menu \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "categories": [
    {
      "id": "cat_31",
      "name": {
        "tr": "Lahmacun ve Pide",
        "en": "Lahmacun and Pide"
      },
      "products": [
        {
          "id": "prd_1042",
          "name": {
            "tr": "Lahmacun"
          },
          "price": "120.00",
          "is_available": true,
          "vat_rate": 10,
          "options": []
        }
      ]
    }
  ],
  "updated_at": "2026-10-26T11:42:08+03:00"
}

curl -X GET https://ristivo.com/api/v1/products \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "prd_1042",
      "category_id": "cat_31",
      "name": {
        "tr": "Lahmacun"
      },
      "price": "120.00",
      "is_available": true,
      "barcode": null,
      "updated_at": "2026-10-26T11:42:08+03:00"
    }
  ],
  "next_cursor": "eyJpZCI6MTA0Mn0"
}

curl -X PATCH https://ristivo.com/api/v1/products/prd_1042 \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "is_available": false
  }'

{
  "id": "prd_1042",
  "price": "120.00",
  "is_available": false,
  "updated_at": "2026-10-26T12:05:31+03:00"
}

curl -X GET https://ristivo.com/api/v1/orders \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "ord_58213",
      "channel": "delivery",
      "status": "open",
      "table": null,
      "items": [
        {
          "product_id": "prd_1042",
          "name": "Lahmacun",
          "quantity": 3,
          "unit_price": "120.00",
          "total": "360.00"
        }
      ],
      "total": "360.00",
      "created_at": "2026-10-26T12:10:02+03:00"
    }
  ],
  "next_cursor": null
}

curl -X GET https://ristivo.com/api/v1/orders/ord_58213 \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "id": "ord_58213",
  "channel": "delivery",
  "status": "closed",
  "total": "360.00",
  "payments": [
    {
      "method": "card",
      "amount": "360.00"
    }
  ],
  "closed_at": "2026-10-26T12:41:19+03:00"
}

curl -X POST https://ristivo.com/api/v1/orders \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "external_id": "WEB-20931",
    "channel": "delivery",
    "items": [
      {
        "product_id": "prd_1042",
        "quantity": 3,
        "note": "Acısız"
      }
    ],
    "customer": {
      "name": "Elif K.",
      "phone": "+905321112233",
      "address": "Barbaros Mah. 1. Sok. No:4 D:2"
    },
    "paid": true
  }'

{
  "id": "ord_58214",
  "status": "open",
  "total": "360.00",
  "created_at": "2026-10-26T12:14:40+03:00"
}

curl -X POST https://ristivo.com/api/v1/orders/ord_58213/payments \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "method": "meal_card",
    "amount": "360.00",
    "reference": "MLT-88120"
  }'

{
  "order_id": "ord_58213",
  "paid": "360.00",
  "remaining": "0.00"
}

curl -X GET https://ristivo.com/api/v1/deliveries \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "dlv_k2m8q4x1v7n3p9r5",
      "status": "ready",
      "source": "yemeksepeti",
      "order_ref": "1042",
      "pickup": {
        "name": "Örnek Lokanta",
        "address": "Çarşı Cad. No:12, Çanakkale",
        "phone": "+90 286 000 00 00"
      },
      "dropoff": {
        "area": "Barbaros, Merkez",
        "lat": 40.14,
        "lng": 26.41
      },
      "order_total": "360.00",
      "collect_on_delivery": "0.00",
      "payment_method": "online",
      "assigned_to_you": false,
      "ready_at": "2026-10-26T12:32:00+03:00"
    }
  ],
  "next_cursor": null
}

curl -X GET https://ristivo.com/api/v1/deliveries/dlv_k2m8q4x1v7n3p9r5 \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "id": "dlv_k2m8q4x1v7n3p9r5",
  "status": "on_the_way",
  "courier": {
    "name": "Mert Y.",
    "company": "Hızlı Kurye"
  },
  "eta_minutes": 6
}

curl -X POST https://ristivo.com/api/v1/deliveries/dlv_k2m8q4x1v7n3p9r5/accept \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "courier": {
      "name": "Mert Y.",
      "phone": "+905339998877",
      "plate": "17 ABC 123"
    },
    "eta_minutes": 6
  }'

{
  "id": "dlv_k2m8q4x1v7n3p9r5",
  "status": "assigned",
  "assigned_to_you": true,
  "dropoff": {
    "name": "Elif K.",
    "phone": "+905321112233",
    "address": "Barbaros Mah. 1. Sok. No:4 D:2",
    "note": "Zili çalmayın",
    "area": "Barbaros, Merkez",
    "lat": 40.139123,
    "lng": 26.412234
  },
  "courier": {
    "name": "Mert Y.",
    "phone": "+905339998877",
    "plate": "17 ABC 123",
    "company": "Hızlı Kurye"
  },
  "accepted_at": "2026-10-26T12:33:10+03:00"
}

curl -X POST https://ristivo.com/api/v1/deliveries/dlv_k2m8q4x1v7n3p9r5/status \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "status": "delivered",
    "lat": 40.1391,
    "lng": 26.4122
  }'

{
  "id": "dlv_k2m8q4x1v7n3p9r5",
  "status": "delivered",
  "delivered_at": "2026-10-26T12:51:47+03:00"
}

curl -X POST https://ristivo.com/api/v1/deliveries \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "external_id": "WEB-20931",
    "recipient": {
      "name": "Elif K.",
      "phone": "+905321112233",
      "address": "Barbaros Mah. 1. Sok. No:4 D:2",
      "area": "Barbaros, Merkez"
    },
    "order_total": "360.00",
    "collect_on_delivery": "0.00",
    "payment_method": "online"
  }'

{
  "id": "dlv_a7c3e9g1k5m2p8s4",
  "status": "ready",
  "external_id": "WEB-20931"
}

curl -X POST https://ristivo.com/api/v1/deliveries/dlv_a7c3e9g1k5m2p8s4/cancel \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "reason": "Müşteri vazgeçti"
  }'

{
  "id": "dlv_a7c3e9g1k5m2p8s4",
  "status": "cancelled"
}

curl -X GET https://ristivo.com/api/v1/sales/daily \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "date": "2026-10-25",
      "gross": "48250.00",
      "discounts": "1200.00",
      "complimentary": "350.00",
      "cancelled": "180.00",
      "net": "46520.00",
      "vat": [
        {
          "rate": 10,
          "base": "38654.55",
          "amount": "3865.45"
        },
        {
          "rate": 20,
          "base": "3333.33",
          "amount": "666.67"
        }
      ],
      "payments": [
        {
          "method": "cash",
          "amount": "9820.00"
        },
        {
          "method": "card",
          "amount": "33100.00"
        },
        {
          "method": "meal_card",
          "amount": "3600.00"
        }
      ],
      "covers": 214
    }
  ]
}

curl -X GET https://ristivo.com/api/v1/sales/end-of-day/2026-10-25 \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "date": "2026-10-25",
  "registers": [
    {
      "name": "Kasa 1",
      "okc_serial": "PAV0000123",
      "z_number": 412,
      "receipts": 186,
      "total": "41210.00",
      "cash_difference": "0.00"
    }
  ]
}

curl -X GET https://ristivo.com/api/v1/invoices \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "inv_3301",
      "type": "e_invoice",
      "number": "RST2026000000412",
      "uuid": "5f0c2e7a-1d4b-4c8e-9a51-7c2b1e0d9f33",
      "buyer_tax_id": "1234567890",
      "total": "6000.00",
      "vat": "1000.00",
      "status": "accepted",
      "pdf_url": "https://ristivo.com/api/v1/invoices/inv_3301/pdf",
      "issued_at": "2026-10-25T21:14:00+03:00"
    }
  ]
}

curl -X GET https://ristivo.com/api/v1/purchases \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "pur_771",
      "supplier": {
        "name": "Ege Gıda",
        "tax_id": "9876543210"
      },
      "number": "EGE2026000001187",
      "total": "14400.00",
      "status": "approved",
      "date": "2026-10-24"
    }
  ]
}

curl -X POST https://ristivo.com/api/v1/purchases \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "supplier_tax_id": "9876543210",
    "number": "EGE2026000001190",
    "date": "2026-10-26",
    "lines": [
      {
        "name": "Kıyma (dana)",
        "quantity": 10,
        "unit": "kg",
        "unit_price": "640.00",
        "vat_rate": 1
      }
    ]
  }'

{
  "id": "pur_772",
  "status": "pending_approval",
  "total": "6464.00"
}

curl -X GET https://ristivo.com/api/v1/stock/levels \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "item_id": "stk_208",
      "name": "Kıyma (dana)",
      "unit": "kg",
      "quantity": "3.200",
      "minimum": "5.000",
      "warehouse": "Mutfak"
    }
  ]
}

curl -X GET https://ristivo.com/api/v1/availability \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "date": "2026-10-31",
  "party_size": 4,
  "slots": [
    "19:00",
    "19:30",
    "21:30"
  ]
}

curl -X POST https://ristivo.com/api/v1/reservations \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "date": "2026-10-31",
    "time": "19:30",
    "party_size": 4,
    "guest": {
      "name": "Can D.",
      "phone": "+905441234567"
    },
    "note": "Cam kenarı"
  }'

{
  "id": "rsv_4410",
  "status": "pending",
  "date": "2026-10-31",
  "time": "19:30",
  "party_size": 4
}

curl -X POST https://ristivo.com/api/v1/reservations/rsv_4410/cancel \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "id": "rsv_4410",
  "status": "cancelled"
}

curl -X GET https://ristivo.com/api/v1/customers \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "cus_1209",
      "name": "Can D.",
      "phone": "+90 544 *** ** 67",
      "email": "c***@gmail.com",
      "visits": 7,
      "last_visit": "2026-10-18",
      "marketing_consent": true
    }
  ]
}

curl -X GET https://ristivo.com/api/v1/webhooks \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "data": [
    {
      "id": "whk_r4t8y2u6i0o3p7a1",
      "url": "https://kurye.example.com/ristivo",
      "events": [
        "delivery.ready"
      ],
      "status": "active",
      "last_success_at": "2026-10-26T12:32:01+03:00",
      "last_error": null
    }
  ]
}

curl -X POST https://ristivo.com/api/v1/webhooks \
  -H "Authorization: Bearer $RISTIVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "url": "https://kurye.example.com/ristivo",
    "events": [
      "delivery.ready",
      "delivery.cancelled"
    ]
  }'

{
  "id": "whk_r4t8y2u6i0o3p7a1",
  "url": "https://kurye.example.com/ristivo",
  "events": [
    "delivery.ready",
    "delivery.cancelled"
  ],
  "status": "active",
  "secret": "whsec_3Jx9…"
}

curl -X DELETE https://ristivo.com/api/v1/webhooks/whk_r4t8y2u6i0o3p7a1 \
  -H "Authorization: Bearer $RISTIVO_KEY"

{
  "id": "whk_r4t8y2u6i0o3p7a1",
  "deleted": true
}