Rechnung teilweise aktualisieren
patch
/api/v1/invoices/{id}
Sicherheit
Parameter
| Name | In | Typ | Details | |
|---|---|---|---|---|
id |
path |
integer
|
Pflicht | Ressourcen-ID |
Request-Body Pflicht
application/json
Schema
{
"type": "object",
"properties": {
"subject": {
"type": "string"
},
"status": {
"type": "string"
},
"invoice_date": {
"type": "string",
"format": "date"
},
"due_date": {
"type": "string",
"format": "date"
},
"total_amount": {
"type": "number"
},
"paid_amount": {
"type": "number"
},
"sales_contract_id": {
"type": "integer"
},
"header_notes": {
"type": "string"
},
"sale": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"example": "EUR"
},
"to_type": {
"type": "string",
"example": "person"
},
"to_first_name": {
"type": "string"
},
"to_last_name": {
"type": "string"
},
"to_email": {
"type": "string",
"format": "email"
},
"to_city": {
"type": "string"
},
"to_countries_id": {
"type": "integer"
},
"sale_items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_title": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"tax_percentage": {
"type": "number"
},
"discount_percentage": {
"type": "number"
},
"is_optional": {
"type": "boolean"
},
"show_price": {
"type": "boolean"
}
}
}
}
}
}
}
}
Antworten
200
Rechnung aktualisiert
application/json
{
"allOf": [
{
"title": "API envelope",
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string",
"nullable": true
},
"errors": {
"nullable": true
},
"meta": {
"type": "object",
"nullable": true,
"additionalProperties": true
}
}
},
{
"type": "object",
"properties": {
"data": {
"title": "Invoice",
"type": "object",
"required": [
"id",
"is_credit_note"
],
"properties": {
"id": {
"type": "integer"
},
"sales_id": {
"type": "integer",
"nullable": true
},
"sales_contract_id": {
"type": "integer",
"nullable": true
},
"status": {
"type": "string",
"nullable": true
},
"invoice_number": {
"type": "string",
"nullable": true
},
"final_invoice_number": {
"type": "string",
"nullable": true
},
"invoice_date": {
"type": "string",
"nullable": true
},
"due_date": {
"type": "string",
"nullable": true
},
"payment_target": {
"type": "string",
"nullable": true
},
"payment_target_interval": {
"type": "string",
"nullable": true
},
"payment_target_count": {
"type": "integer",
"nullable": true
},
"subject": {
"type": "string",
"nullable": true
},
"header_notes": {
"type": "string",
"nullable": true
},
"footer_notes": {
"type": "string",
"nullable": true
},
"total_amount": {
"type": "number",
"nullable": true
},
"paid_amount": {
"type": "number",
"nullable": true
},
"payment_percent": {
"type": "number",
"nullable": true
},
"payment_stage": {
"type": "string",
"nullable": true
},
"sent_at": {
"type": "string",
"nullable": true
},
"performance_date_start": {
"type": "string",
"nullable": true
},
"performance_date_end": {
"type": "string",
"nullable": true
},
"performance_date_type": {
"type": "string",
"nullable": true
},
"is_credit_note": {
"type": "boolean"
},
"original_invoice_id": {
"type": "integer",
"nullable": true
},
"credit_note_id": {
"type": "integer",
"nullable": true
},
"credit_reason": {
"type": "string",
"nullable": true
},
"created_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"updated_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"sale": {
"oneOf": [
{
"title": "Sale",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"unique_order_id": {
"type": "string",
"nullable": true
},
"currency": {
"type": "string",
"nullable": true
},
"to_type": {
"type": "string",
"nullable": true
},
"to_first_name": {
"type": "string",
"nullable": true
},
"to_last_name": {
"type": "string",
"nullable": true
},
"to_email": {
"type": "string",
"format": "email",
"nullable": true
},
"to_company_name": {
"type": "string",
"nullable": true
},
"to_address": {
"type": "string",
"nullable": true
},
"to_city": {
"type": "string",
"nullable": true
},
"to_zipcode": {
"type": "string",
"nullable": true
},
"to_countries_id": {
"type": "integer",
"nullable": true
},
"to_contact_id": {
"type": "integer",
"nullable": true
},
"to_organization_id": {
"type": "integer",
"nullable": true
},
"from_first_name": {
"type": "string",
"nullable": true
},
"from_last_name": {
"type": "string",
"nullable": true
},
"from_email": {
"type": "string",
"format": "email",
"nullable": true
},
"from_company_name": {
"type": "string",
"nullable": true
},
"from_address": {
"type": "string",
"nullable": true
},
"from_city": {
"type": "string",
"nullable": true
},
"from_zipcode": {
"type": "string",
"nullable": true
},
"from_countries_id": {
"type": "integer",
"nullable": true
},
"deals_unique_id": {
"type": "integer",
"nullable": true
},
"created_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"sale_items": {
"type": "array",
"items": {
"title": "Sale item",
"type": "object",
"required": [
"id",
"is_optional",
"show_price"
],
"properties": {
"id": {
"type": "integer"
},
"product_id": {
"type": "integer",
"nullable": true
},
"product_title": {
"type": "string",
"nullable": true
},
"product_description": {
"type": "string",
"nullable": true
},
"quantity": {
"type": "number",
"nullable": true
},
"unit_price": {
"type": "number",
"nullable": true
},
"tax_percentage": {
"type": "number",
"nullable": true
},
"discount_percentage": {
"type": "number",
"nullable": true
},
"unit_id": {
"type": "integer",
"nullable": true
},
"unit_name": {
"type": "string",
"nullable": true
},
"display_order": {
"type": "integer",
"nullable": true
},
"is_optional": {
"type": "boolean"
},
"show_price": {
"type": "boolean"
}
}
}
}
}
},
{
"type": "null"
}
]
}
}
}
}
}
]
}
401
Missing or invalid API key
application/json
{
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": false
},
"message": {
"type": "string",
"example": "Missing API key (X-Api-Key)"
}
}
}
404
Resource not found
application/json
{
"title": "API envelope",
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string",
"nullable": true
},
"errors": {
"nullable": true
},
"meta": {
"type": "object",
"nullable": true,
"additionalProperties": true
}
}
}
422
Validation failed
application/json
{
"title": "API envelope",
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string",
"nullable": true
},
"errors": {
"nullable": true
},
"meta": {
"type": "object",
"nullable": true,
"additionalProperties": true
}
}
}