Skip to main content
PUT
/
api
/
payment-terms
/
{id}
Update Payment Term
curl --request PUT \
  --url https://qwoty.app/api/payment-terms/{id} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "api_name": "<string>",
  "reference": "<string>",
  "is_active": true,
  "id_crm": "<string>",
  "id_erp": "<string>",
  "id_accounting": "<string>",
  "installments": [
    {
      "name": "<string>",
      "percentage": 123,
      "term": {},
      "custom_text": "<string>",
      "order_number": 123
    }
  ]
}
'
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Net 30 Days (Updated)",
    "api_name": "net_30_days",
    "reference": "PT001",
    "is_active": true,
    "id_crm": "crm_123",
    "id_erp": "erp_456",
    "id_accounting": "acc_789",
    "installments": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "name": "Full Payment",
        "percentage": 100,
        "term": "net30",
        "custom_text": null,
        "order_number": 1
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

​
Authorization

​
Authorization
string
required
Bearer token for authentication. Format: Bearer qwoty_your_token

​
Path Parameters

​
id
string
required
UUID of the payment term to update

​
Request Body

​
name
string
Name of the payment term (max 50 characters)
​
api_name
string
Unique API identifier (slug format)
​
reference
string
Internal reference code (max 50 characters)
​
is_active
boolean
Whether the payment term is active
​
id_crm
string
External CRM identifier
​
id_erp
string
External ERP identifier
​
id_accounting
string
External accounting system identifier
​
installments
array
Array of payment installments. If provided, replaces all existing installments.
You can update individual fields or the entire payment term. Omitted fields remain unchanged.
If updating installments, the sum of all percentages must equal 100%.

​
Examples

curl -X PUT https://qwoty.app/api/payment-terms/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Net 30 Days (Updated)"
  }'

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The updated payment term object with all fields
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Net 30 Days (Updated)",
    "api_name": "net_30_days",
    "reference": "PT001",
    "is_active": true,
    "id_crm": "crm_123",
    "id_erp": "erp_456",
    "id_accounting": "acc_789",
    "installments": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "name": "Full Payment",
        "percentage": 100,
        "term": "net30",
        "custom_text": null,
        "order_number": 1
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

​
Error Responses

{
  "success": false,
  "error": "Payment term not found"
}