{"openapi":"3.1.0","info":{"title":"PUT /api/v1/vendor-credits/{vendor_credit_id}","version":"1.0.0","description":"Update vendor credit"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/vendor-credits/{vendor_credit_id}":{"put":{"tags":["vendor-credits"],"summary":"Update vendor credit","description":"Update a draft vendor credit.","operationId":"update_vendor_credit_api_v1_vendor_credits__vendor_credit_id__put","parameters":[{"name":"vendor_credit_id","in":"path","required":true,"schema":{"type":"string","title":"Vendor Credit Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorCreditUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorCreditResponse"}}}},"400":{"description":"Bad Request - Invalid input","content":{"application/json":{"example":{"detail":"Invalid request parameters"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"404":{"description":"Not Found - Resource does not exist","content":{"application/json":{"example":{"detail":"Resource not found"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VendorCreditApplicationResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Application record ID"},"vendor_credit_id":{"type":"string","title":"Vendor Credit Id","description":"Source vendor credit ID"},"bill_id":{"type":"string","title":"Bill Id","description":"Bill the credit was applied to"},"amount_applied":{"type":"integer","title":"Amount Applied","description":"Amount applied in cents"},"amount_applied_dollars":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Applied Dollars","description":"Amount applied in dollars"},"applied_at":{"type":"string","format":"date-time","title":"Applied At","description":"When the credit was applied"},"applied_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applied By User Id","description":"User who applied the credit"},"bill_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Number","description":"Vendor bill number (when application loaded with bill)"}},"type":"object","required":["id","vendor_credit_id","bill_id","amount_applied","amount_applied_dollars","applied_at"],"title":"VendorCreditApplicationResponse","description":"Response schema for a vendor credit application."},"VendorCreditLineItem":{"properties":{"description":{"type":"string","title":"Description","description":"Line item description"},"quantity":{"type":"integer","minimum":1.0,"title":"Quantity","description":"Quantity","default":1},"unit_price_cents":{"type":"integer","title":"Unit Price Cents","description":"Unit price in cents"},"amount_cents":{"type":"integer","title":"Amount Cents","description":"Total amount in cents (qty * unit_price)"}},"type":"object","required":["description","unit_price_cents","amount_cents"],"title":"VendorCreditLineItem","description":"Line item for vendor credit details."},"VendorCreditReasonEnum":{"type":"string","enum":["returned_goods","damaged_goods","service_issue","pricing_error","billing_adjustment","rebate","duplicate_charge","other"],"title":"VendorCreditReasonEnum","description":"Standard reasons for receiving a vendor credit."},"VendorCreditResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Vendor credit ID"},"business_id":{"type":"string","title":"Business Id","description":"Business receiving the credit"},"vendor_id":{"type":"string","title":"Vendor Id","description":"Vendor issuing the credit"},"bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Id","description":"Original bill being credited"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number","description":"Auto-generated vendor credit number (e.g. VC-0001)"},"vendor_credit_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Credit Number","description":"Vendor's own reference number (from the credit doc)"},"status":{"type":"string","title":"Status","description":"Status: draft, issued, partially_applied, applied, void"},"currency":{"type":"string","title":"Currency","description":"ISO currency code (e.g. USD)"},"amount":{"type":"integer","title":"Amount","description":"Total credit amount in cents"},"amount_in_dollars":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount In Dollars","description":"Total credit amount in dollars"},"amount_applied":{"type":"integer","title":"Amount Applied","description":"Amount applied in cents"},"amount_applied_in_dollars":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Applied In Dollars","description":"Amount applied in dollars"},"amount_remaining":{"type":"integer","title":"Amount Remaining","description":"Remaining amount in cents"},"amount_remaining_in_dollars":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Remaining In Dollars","description":"Remaining amount in dollars"},"issue_date":{"type":"string","format":"date","title":"Issue Date","description":"Date the credit was issued"},"applied_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Applied Date","description":"When credits were fully applied"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Record creation timestamp"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Last update timestamp"},"reason":{"type":"string","title":"Reason","description":"Reason code"},"reason_display":{"type":"string","title":"Reason Display","description":"Human-readable reason label"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the credit"},"internal_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Internal Notes","description":"Internal notes"},"line_items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Line Items","description":"Detailed line items breakdown"},"voided_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Voided At","description":"When the credit was voided"},"voided_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voided Reason","description":"Reason for voiding"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name","description":"Vendor display name"},"bill_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Number","description":"Original bill number"},"bill_applications":{"anyOf":[{"items":{"$ref":"#/components/schemas/VendorCreditApplicationResponse"},"type":"array"},{"type":"null"}],"title":"Bill Applications","description":"Applications to bills"},"can_be_applied":{"type":"boolean","title":"Can Be Applied","description":"Whether credits can be applied to bills"},"can_be_voided":{"type":"boolean","title":"Can Be Voided","description":"Whether the credit can be voided"},"can_be_deleted":{"type":"boolean","title":"Can Be Deleted","description":"Whether the credit can be deleted (drafts only)"},"has_applications":{"type":"boolean","title":"Has Applications","description":"Whether any credits have been applied"}},"type":"object","required":["id","business_id","vendor_id","status","currency","amount","amount_in_dollars","amount_applied","amount_applied_in_dollars","amount_remaining","amount_remaining_in_dollars","issue_date","created_at","updated_at","reason","reason_display","can_be_applied","can_be_voided","can_be_deleted","has_applications"],"title":"VendorCreditResponse","description":"Response schema for a vendor credit.","example":{"amount":5000,"amount_applied":0,"amount_applied_in_dollars":0.0,"amount_in_dollars":50.0,"amount_remaining":5000,"amount_remaining_in_dollars":50.0,"business_id":"019ab37c-bus1-7000-8000-000000000001","can_be_applied":true,"can_be_deleted":false,"can_be_voided":true,"currency":"USD","description":"Overcharged on bill #BILL-001","has_applications":false,"id":"019ab37c-vc01-7000-8000-000000000001","issue_date":"2026-01-07","number":"VC-0001","reason":"pricing_error","reason_display":"Pricing Error","status":"issued","vendor_id":"019ab37c-vend-7000-8000-000000000001"}},"VendorCreditUpdate":{"properties":{"amount_cents":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Amount Cents","description":"Credit amount in cents"},"reason":{"anyOf":[{"$ref":"#/components/schemas/VendorCreditReasonEnum"},{"type":"null"}],"description":"Reason for the vendor credit"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Description of the credit"},"bill_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill Id","description":"Original bill being credited"},"issue_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Issue Date","description":"Issue date"},"line_items":{"anyOf":[{"items":{"$ref":"#/components/schemas/VendorCreditLineItem"},"type":"array"},{"type":"null"}],"title":"Line Items","description":"Line items for credit detail"},"internal_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Internal Notes","description":"Internal notes"},"vendor_credit_number":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Vendor Credit Number","description":"Vendor's reference number"}},"type":"object","title":"VendorCreditUpdate","description":"Request schema for updating a vendor credit (draft only)."}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}