{"info":{"name":"Bicops Partner API v1","description":"Two-way integration API for Bicops sellers and corporate partners. Set the collection variables apiKey / apiSecret (issued by Bicops) and baseUrl (https://partner.bicops.tr). Docs: https://partner.bicops.tr/en · OpenAPI: https://partner.bicops.tr/docs/openapi.json","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-Api-Key","type":"string"},{"key":"value","value":"{{apiKey}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["pm.request.headers.upsert({ key: 'X-Api-Key', value: pm.collectionVariables.get('apiKey') });","pm.request.headers.upsert({ key: 'X-Api-Secret', value: pm.collectionVariables.get('apiSecret') });"]}}],"variable":[{"key":"baseUrl","value":"https://partner.bicops.tr","type":"string"},{"key":"apiKey","value":"","type":"string"},{"key":"apiSecret","value":"","type":"string"},{"key":"batchId","value":"1","type":"string"},{"key":"orderId","value":"1","type":"string"},{"key":"returnId","value":"1","type":"string"},{"key":"webhookId","value":"1","type":"string"},{"key":"customerId","value":"1","type":"string"}],"item":[{"name":"0. Connectivity","item":[{"name":"GET me — connectivity test","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/me","host":["{{baseUrl}}"],"path":["v1","me"]},"description":"Returns identity, scopes and limits of the key."}},{"name":"GET health","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/health","host":["{{baseUrl}}"],"path":["health"]}}}]},{"name":"1. Catalog","item":[{"name":"POST products (bulk upsert)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/products","host":["{{baseUrl}}"],"path":["v1","catalog","products"]},"body":{"mode":"raw","raw":"{\n  \"items\": [\n    {\n      \"sourceId\": \"SACHS 317 572\",\n      \"name\": \"AMORTISOR ON AUDI A3 / GOLF V\",\n      \"brand\": \"SACHS\",\n      \"producerCode\": \"317 572\",\n      \"oemCodes\": [\n        \"1T0413031CN\",\n        \"1T0413031CK\"\n      ],\n      \"equivalentCodes\": [\n        \"FEBI 106124\"\n      ],\n      \"price\": 3869.6,\n      \"currency\": \"TRY\",\n      \"pricesIncludeVat\": false,\n      \"stock\": 12,\n      \"warehouses\": [\n        {\n          \"code\": \"ANK\",\n          \"stock\": 8\n        },\n        {\n          \"code\": \"IZM\",\n          \"stock\": 4\n        }\n      ],\n      \"minOrder\": 1,\n      \"packageAmount\": 1,\n      \"unit\": \"AD\",\n      \"desi\": 3.2,\n      \"images\": [\n        \"https://cdn.example.com/317572.jpg\"\n      ],\n      \"status\": 1\n    }\n  ]\n}","options":{"raw":{"language":"json"}}},"description":"Up to 1,000 items. Returns 202 + batchId."}},{"name":"POST products — dryRun","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/products?dryRun=true","host":["{{baseUrl}}"],"path":["v1","catalog","products"],"query":[{"key":"dryRun","value":"true","disabled":false}]},"body":{"mode":"raw","raw":"{\n  \"items\": [\n    {\n      \"sourceId\": \"SACHS 317 572\",\n      \"name\": \"AMORTISOR ON AUDI A3 / GOLF V\",\n      \"brand\": \"SACHS\",\n      \"producerCode\": \"317 572\",\n      \"oemCodes\": [\n        \"1T0413031CN\",\n        \"1T0413031CK\"\n      ],\n      \"equivalentCodes\": [\n        \"FEBI 106124\"\n      ],\n      \"price\": 3869.6,\n      \"currency\": \"TRY\",\n      \"pricesIncludeVat\": false,\n      \"stock\": 12,\n      \"warehouses\": [\n        {\n          \"code\": \"ANK\",\n          \"stock\": 8\n        },\n        {\n          \"code\": \"IZM\",\n          \"stock\": 4\n        }\n      ],\n      \"minOrder\": 1,\n      \"packageAmount\": 1,\n      \"unit\": \"AD\",\n      \"desi\": 3.2,\n      \"images\": [\n        \"https://cdn.example.com/317572.jpg\"\n      ],\n      \"status\": 1\n    },\n    {\n      \"sourceId\": \"BAD-1\",\n      \"price\": -1\n    }\n  ]\n}","options":{"raw":{"language":"json"}}},"description":"Validates only; nothing is written."}},{"name":"PATCH stock","request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/stock","host":["{{baseUrl}}"],"path":["v1","catalog","stock"]},"body":{"mode":"raw","raw":"{\n  \"items\": [\n    {\n      \"sourceId\": \"SACHS 317 572\",\n      \"stock\": 9,\n      \"warehouses\": [\n        {\n          \"code\": \"ANK\",\n          \"stock\": 5\n        },\n        {\n          \"code\": \"IZM\",\n          \"stock\": 4\n        }\n      ]\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"PATCH prices","request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/prices","host":["{{baseUrl}}"],"path":["v1","catalog","prices"]},"body":{"mode":"raw","raw":"{\n  \"items\": [\n    {\n      \"sourceId\": \"SACHS 317 572\",\n      \"price\": 3999.9,\n      \"currency\": \"TRY\"\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"DELETE product (deactivate)","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/products/SACHS 317 572","host":["{{baseUrl}}"],"path":["v1","catalog","products","SACHS 317 572"]}}},{"name":"POST products/deactivate (bulk)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/products/deactivate","host":["{{baseUrl}}"],"path":["v1","catalog","products","deactivate"]},"body":{"mode":"raw","raw":"{\n  \"sourceIds\": [\n    \"SACHS 317 572\",\n    \"A-1002\"\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET products (our view)","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/products?pageSize=50&updatedSince=2026-01-01T00:00:00Z&sourceId=SACHS 317 572&status=1","host":["{{baseUrl}}"],"path":["v1","catalog","products"],"query":[{"key":"pageSize","value":"50","disabled":false},{"key":"updatedSince","value":"2026-01-01T00:00:00Z","disabled":true},{"key":"sourceId","value":"SACHS 317 572","disabled":true},{"key":"status","value":"1","disabled":true}]}}},{"name":"POST imports (presigned upload)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/catalog/imports","host":["{{baseUrl}}"],"path":["v1","catalog","imports"]},"body":{"mode":"raw","raw":"{\n  \"format\": \"ndjson\",\n  \"gzip\": true,\n  \"dryRun\": false\n}","options":{"raw":{"language":"json"}}},"description":"Then PUT the file to uploadUrl and call /complete."}},{"name":"POST imports/{batchId}/complete","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/imports/{{batchId}}/complete","host":["{{baseUrl}}"],"path":["v1","catalog","imports","{{batchId}}","complete"]}}},{"name":"GET batches","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/batches?pageSize=20&kind=products","host":["{{baseUrl}}"],"path":["v1","catalog","batches"],"query":[{"key":"pageSize","value":"20","disabled":false},{"key":"kind","value":"products","disabled":true}]}}},{"name":"GET batches/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/batches/{{batchId}}","host":["{{baseUrl}}"],"path":["v1","catalog","batches","{{batchId}}"]}}},{"name":"GET batches/{id}/errors","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/batches/{{batchId}}/errors?severity=error&pageSize=200","host":["{{baseUrl}}"],"path":["v1","catalog","batches","{{batchId}}","errors"],"query":[{"key":"severity","value":"error","disabled":true},{"key":"pageSize","value":"200","disabled":false}]}}},{"name":"GET batches/{id}/errors.csv","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/catalog/batches/{{batchId}}/errors.csv","host":["{{baseUrl}}"],"path":["v1","catalog","batches","{{batchId}}","errors.csv"]}}}]},{"name":"2. Orders","item":[{"name":"GET orders","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders?status=new&updatedSince=2026-01-01T00:00:00Z&page=0&pageSize=50","host":["{{baseUrl}}"],"path":["v1","orders"],"query":[{"key":"status","value":"new","disabled":true},{"key":"updatedSince","value":"2026-01-01T00:00:00Z","disabled":true},{"key":"page","value":"0","disabled":false},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET orders/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}"]}}},{"name":"POST orders/{id}/approve","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","approve"]}}},{"name":"POST orders/{id}/status","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/status","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","status"]},"body":{"mode":"raw","raw":"{\n  \"status\": \"preparing\"\n}","options":{"raw":{"language":"json"}}},"description":"new | preparing | problem | waiting_approval | waiting_payment | in_cargo | cancelled | completed"}},{"name":"POST orders/{id}/erp-reference","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/erp-reference","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","erp-reference"]},"body":{"mode":"raw","raw":"{\n  \"reference\": \"ERP-2026-000123\",\n  \"meta\": {\n    \"warehouse\": \"ANK\"\n  }\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET orders/{id}/messages","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/messages","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","messages"]}}},{"name":"GET orders/{id}/documents","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/documents","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","documents"]}}}]},{"name":"3. Shipping","item":[{"name":"GET orders/carriers","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/carriers","host":["{{baseUrl}}"],"path":["v1","orders","carriers"]}}},{"name":"POST orders/{id}/shipments (own carrier)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/shipments","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","shipments"]},"body":{"mode":"raw","raw":"{\n  \"cargoId\": 61,\n  \"trackNumber\": \"TR123456789\",\n  \"trackUrl\": \"https://carrier.example.com/track/TR123456789\",\n  \"shipmentDate\": \"2026-09-23\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"POST orders/{id}/shipments/create (Bicops carrier)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/shipments/create","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","shipments","create"]},"body":{"mode":"raw","raw":"{\n  \"warehouse\": \"ANK\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET orders/{id}/shipments/label","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/shipments/label?warehouse=ANK","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","shipments","label"],"query":[{"key":"warehouse","value":"ANK","disabled":true}]}}}]},{"name":"4. Returns & cancellations","item":[{"name":"GET returns","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/returns?status=1&updatedSince=2026-01-01T00:00:00Z&pageSize=50","host":["{{baseUrl}}"],"path":["v1","returns"],"query":[{"key":"status","value":"1","disabled":true},{"key":"updatedSince","value":"2026-01-01T00:00:00Z","disabled":true},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET returns/{id}","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/returns/{{returnId}}","host":["{{baseUrl}}"],"path":["v1","returns","{{returnId}}"]}}},{"name":"POST returns/{id}/decision","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/returns/{{returnId}}/decision","host":["{{baseUrl}}"],"path":["v1","returns","{{returnId}}","decision"]},"body":{"mode":"raw","raw":"{\n  \"action\": \"approve\",\n  \"notes\": \"Accepted, refund in 3 days\",\n  \"returnCargoId\": 66\n}","options":{"raw":{"language":"json"}}}}},{"name":"GET cancellations","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/cancellations?since=2026-01-01T00:00:00Z","host":["{{baseUrl}}"],"path":["v1","cancellations"],"query":[{"key":"since","value":"2026-01-01T00:00:00Z","disabled":true}]}}}]},{"name":"5. Invoices","item":[{"name":"GET orders/{id}/invoices","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/invoices","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","invoices"]}}},{"name":"POST orders/{id}/invoice (attach)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/orders/{{orderId}}/invoice","host":["{{baseUrl}}"],"path":["v1","orders","{{orderId}}","invoice"]},"body":{"mode":"raw","raw":"{\n  \"fileUrl\": \"https://erp.example.com/invoices/INV-2026-000123.pdf\",\n  \"fileName\": \"INV-2026-000123.pdf\",\n  \"invoiceType\": 0,\n  \"invoiceDate\": \"2026-09-23\"\n}","options":{"raw":{"language":"json"}}},"description":"Alternatively fileBase64."}},{"name":"GET invoices (issued to you)","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/invoices?since=2026-01-01T00:00:00Z","host":["{{baseUrl}}"],"path":["v1","invoices"],"query":[{"key":"since","value":"2026-01-01T00:00:00Z","disabled":true}]}}}]},{"name":"6. Finance","item":[{"name":"GET finance/settlements","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/finance/settlements?from=2026-01-01&to=2026-12-31&pageSize=50","host":["{{baseUrl}}"],"path":["v1","finance","settlements"],"query":[{"key":"from","value":"2026-01-01","disabled":true},{"key":"to","value":"2026-12-31","disabled":true},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET finance/statement","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/finance/statement?from=2026-01-01&to=2026-12-31","host":["{{baseUrl}}"],"path":["v1","finance","statement"],"query":[{"key":"from","value":"2026-01-01","disabled":true},{"key":"to","value":"2026-12-31","disabled":true}]}}},{"name":"GET finance/payments","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/finance/payments?since=2026-01-01T00:00:00Z","host":["{{baseUrl}}"],"path":["v1","finance","payments"],"query":[{"key":"since","value":"2026-01-01T00:00:00Z","disabled":true}]}}}]},{"name":"7. Reports","item":[{"name":"GET reports/sales (day)","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/reports/sales?groupBy=day&from=2026-01-01&to=2026-12-31","host":["{{baseUrl}}"],"path":["v1","reports","sales"],"query":[{"key":"groupBy","value":"day","disabled":false},{"key":"from","value":"2026-01-01","disabled":true},{"key":"to","value":"2026-12-31","disabled":true}]}}},{"name":"GET reports/sales (product)","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/reports/sales?groupBy=product","host":["{{baseUrl}}"],"path":["v1","reports","sales"],"query":[{"key":"groupBy","value":"product","disabled":false}]}}},{"name":"GET reports/returns","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/reports/returns","host":["{{baseUrl}}"],"path":["v1","reports","returns"]}}},{"name":"GET reports/catalog","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/reports/catalog","host":["{{baseUrl}}"],"path":["v1","reports","catalog"]}}},{"name":"GET reports/demand","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/reports/demand","host":["{{baseUrl}}"],"path":["v1","reports","demand"]}}}]},{"name":"8. Webhooks & events","item":[{"name":"GET webhooks","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/webhooks","host":["{{baseUrl}}"],"path":["v1","webhooks"]}}},{"name":"POST webhooks (register)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/webhooks","host":["{{baseUrl}}"],"path":["v1","webhooks"]},"body":{"mode":"raw","raw":"{\n  \"url\": \"https://erp.example.com/bicops/webhook\",\n  \"events\": [\n    \"order.created\",\n    \"order.status.changed\",\n    \"return.requested\",\n    \"catalog.batch.completed\"\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"POST webhooks/{id}/test","request":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/v1/webhooks/{{webhookId}}/test","host":["{{baseUrl}}"],"path":["v1","webhooks","{{webhookId}}","test"]}}},{"name":"DELETE webhooks/{id}","request":{"method":"DELETE","header":[],"url":{"raw":"{{baseUrl}}/v1/webhooks/{{webhookId}}","host":["{{baseUrl}}"],"path":["v1","webhooks","{{webhookId}}"]}}},{"name":"GET webhooks/deliveries","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/webhooks/deliveries?eventId=1&pageSize=50","host":["{{baseUrl}}"],"path":["v1","webhooks","deliveries"],"query":[{"key":"eventId","value":"1","disabled":true},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET events (polling)","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/events?cursor=0&limit=100&types=order.created,order.status.changed","host":["{{baseUrl}}"],"path":["v1","events"],"query":[{"key":"cursor","value":"0","disabled":false},{"key":"limit","value":"100","disabled":false},{"key":"types","value":"order.created,order.status.changed","disabled":true}]}}}]},{"name":"9. Logs","item":[{"name":"GET logs/requests","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/logs/requests?since=2026-09-01T00:00:00Z&status=500&pageSize=100","host":["{{baseUrl}}"],"path":["v1","logs","requests"],"query":[{"key":"since","value":"2026-09-01T00:00:00Z","disabled":true},{"key":"status","value":"500","disabled":true},{"key":"pageSize","value":"100","disabled":false}]}}}]},{"name":"10. Corporate (branch key)","item":[{"name":"GET customers","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/customers?search=&updatedSince=2026-01-01T00:00:00Z&pageSize=50","host":["{{baseUrl}}"],"path":["v1","customers"],"query":[{"key":"search","value":"","disabled":true},{"key":"updatedSince","value":"2026-01-01T00:00:00Z","disabled":true},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET customers/{id}/statement","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/customers/{{customerId}}/statement?from=2026-01-01&to=2026-12-31","host":["{{baseUrl}}"],"path":["v1","customers","{{customerId}}","statement"],"query":[{"key":"from","value":"2026-01-01","disabled":true},{"key":"to","value":"2026-12-31","disabled":true}]}}},{"name":"GET accounting/receipts","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/accounting/receipts?since=2026-01-01T00:00:00Z","host":["{{baseUrl}}"],"path":["v1","accounting","receipts"],"query":[{"key":"since","value":"2026-01-01T00:00:00Z","disabled":true}]}}},{"name":"GET accounting/invoices","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/accounting/invoices?since=2026-01-01T00:00:00Z&pageSize=50","host":["{{baseUrl}}"],"path":["v1","accounting","invoices"],"query":[{"key":"since","value":"2026-01-01T00:00:00Z","disabled":true},{"key":"pageSize","value":"50","disabled":false}]}}},{"name":"GET salesmen","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/v1/salesmen","host":["{{baseUrl}}"],"path":["v1","salesmen"]}}}]}]}