{"openapi":"3.1.0","info":{"title":"Lotzano Connect API","version":"2026-08-30"},"servers":[{"url":"https://{lotzano-host}/api/connect/v1","variables":{"lotzano-host":{"default":"connect-host-wordt-uitgegeven.invalid","description":"Placeholder; Lotzano geeft de echte HTTPS-host pas per omgeving uit."}}}],"security":[{"bearerAuth":[],"hmacSignature":[]}],"paths":{"/records":{"post":{"operationId":"ingestCanonicalRecords","summary":"Accepteer een idempotente, ondertekende batch canonieke records","parameters":[{"in":"header","name":"X-Lotzano-Connection-Id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"header","name":"X-Lotzano-Subscription-Id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"header","name":"X-Lotzano-Event-Id","required":true,"schema":{"type":"string","maxLength":300}},{"in":"header","name":"X-Lotzano-Timestamp","required":true,"schema":{"type":"string","format":"date-time"}},{"in":"header","name":"X-Lotzano-Signature","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerRecordEnvelope"}}}},"responses":{"200":{"description":"Reeds eerder idempotent verwerkt"},"202":{"description":"Duurzaam geaccepteerd"},"400":{"description":"Headers, JSON, contract of replayvenster ongeldig"},"401":{"description":"Authenticatie of signature ongeldig"},"409":{"description":"Event-id is met andere inhoud hergebruikt"},"413":{"description":"Payload te groot"},"503":{"description":"Veilige geheime opslag tijdelijk niet beschikbaar"}}}}},"webhooks":{"connectEvent":{"post":{"summary":"Ondertekende uitgaande Connect-gebeurtenis","parameters":[{"in":"header","name":"X-Lotzano-Event-Id","required":true,"schema":{"type":"string","maxLength":300}},{"in":"header","name":"X-Lotzano-Timestamp","required":true,"schema":{"type":"string","format":"date-time"}},{"in":"header","name":"X-Lotzano-Signature","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectWebhookEnvelope"}}}},"responses":{"200":{"description":"Ontvangen"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"hmacSignature":{"type":"apiKey","in":"header","name":"X-Lotzano-Signature","description":"HMAC-SHA256 over <timestamp>.<exacte request body>"}},"schemas":{"CanonicalRecord":{"type":"object","required":["objectType","data"],"additionalProperties":false,"properties":{"objectType":{"type":"string","enum":["PRODUCT","MEDIA","SALES_UNIT","PRICE_LIST","PRICE","WAREHOUSE","INVENTORY_LEVEL","ORDER","ORDER_COMMAND","FULFILLMENT","RETURN","INVOICE"]},"data":{"type":"object"}}},"PartnerRecordEnvelope":{"type":"object","required":["apiVersion","domain","records","sentAt"],"additionalProperties":false,"properties":{"apiVersion":{"const":"2026-08-30"},"domain":{"type":"string","enum":["CATALOG","MEDIA","PACKS","PRICES","INVENTORY","ORDERS","FULFILLMENT","RETURNS","INVOICES"]},"records":{"type":"array","minItems":1,"maxItems":500,"items":{"$ref":"#/components/schemas/CanonicalRecord"}},"sentAt":{"type":"string","format":"date-time"}}},"ConnectWebhookEnvelope":{"type":"object","required":["apiVersion","eventId","topic","occurredAt","payload"],"additionalProperties":false,"properties":{"apiVersion":{"const":"2026-08-30"},"eventId":{"type":"string","maxLength":300},"topic":{"type":"string","maxLength":160},"occurredAt":{"type":"string","format":"date-time"},"payload":{"type":"object"}}}}}}