Actualizar documento de cobro
curl --request PUT \
--url https://api.cobrix.co/api/v1/invoices/{invoiceId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reference": "V12345678",
"amount": 25,
"name": "Plan mensual actualizado"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({reference: 'V12345678', amount: 25, name: 'Plan mensual actualizado'})
};
fetch('https://api.cobrix.co/api/v1/invoices/{invoiceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.cobrix.co/api/v1/invoices/{invoiceId}"
payload = {
"reference": "V12345678",
"amount": 25,
"name": "Plan mensual actualizado"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"amount": 123,
"provider": "<string>",
"provider_id": "<string>",
"reference": "<string>",
"status": "CREATED",
"remarks": "<string>",
"metadata": {},
"due_date": "2023-12-25",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_test": true,
"partial_payment_config": null,
"payment": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "<string>",
"currency": "<string>",
"amount": 123,
"amount_label": "<string>",
"title": "<string>",
"description": "<string>",
"phone": "<string>",
"expiration_at": "2023-11-07T05:31:56Z",
"due_date": "2023-12-25",
"document_link": "<string>",
"external_id": "<string>",
"allows": {
"accounts": true,
"cards": true,
"card_extra": true,
"realtime": true
},
"status": "<string>",
"is_test": true,
"created_at": "2023-11-07T05:31:56Z",
"paid_at": "2023-11-07T05:31:56Z",
"payment_link": "<string>",
"redirect_url": "<string>",
"provider_id": "<string>",
"metadata": null,
"customer": null,
"method": null,
"splits": [
{}
],
"company": null,
"commission": null
}
}API pública de documentos de cobro
Actualizar documento de cobro
En CREATED sin pagos permite cambiar monto y datos, ajusta el ledger y reemplaza el checkout. Con pagos aplicados responde 409. En PAID, CONCILIATED o PAID_FROM_PROVIDER solo permite datos informativos y exige el mismo monto. provider es inmutable. Requiere public_invoices:write.
PUT
/
v1
/
invoices
/
{invoiceId}
Actualizar documento de cobro
curl --request PUT \
--url https://api.cobrix.co/api/v1/invoices/{invoiceId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reference": "V12345678",
"amount": 25,
"name": "Plan mensual actualizado"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({reference: 'V12345678', amount: 25, name: 'Plan mensual actualizado'})
};
fetch('https://api.cobrix.co/api/v1/invoices/{invoiceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.cobrix.co/api/v1/invoices/{invoiceId}"
payload = {
"reference": "V12345678",
"amount": 25,
"name": "Plan mensual actualizado"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"amount": 123,
"provider": "<string>",
"provider_id": "<string>",
"reference": "<string>",
"status": "CREATED",
"remarks": "<string>",
"metadata": {},
"due_date": "2023-12-25",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"is_test": true,
"partial_payment_config": null,
"payment": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"source": "<string>",
"currency": "<string>",
"amount": 123,
"amount_label": "<string>",
"title": "<string>",
"description": "<string>",
"phone": "<string>",
"expiration_at": "2023-11-07T05:31:56Z",
"due_date": "2023-12-25",
"document_link": "<string>",
"external_id": "<string>",
"allows": {
"accounts": true,
"cards": true,
"card_extra": true,
"realtime": true
},
"status": "<string>",
"is_test": true,
"created_at": "2023-11-07T05:31:56Z",
"paid_at": "2023-11-07T05:31:56Z",
"payment_link": "<string>",
"redirect_url": "<string>",
"provider_id": "<string>",
"metadata": null,
"customer": null,
"method": null,
"splits": [
{}
],
"company": null,
"commission": null
}
}Authorizations
Llave cbx_live con scope de documentos públicos.
Path Parameters
Body
application/json
provider no está permitido. Un PUT debe enviar los campos requeridos completos.
Cédula o RIF del cliente. Puede cambiar de formato únicamente si normaliza a la misma identidad fiscal.
Required string length:
1 - 100Required range:
0.01 <= x <= 1000000Must be a multiple of 0.01Required string length:
5 - 100Inmutable después de crear el documento.
Required string length:
1 - 255Required string length:
4 - 2000Pattern:
^\+[1-9][0-9]{7,14}$Maximum string length:
200Response
Documento actualizado
Available options:
CREATED, PAID, CONCILIATED, PAID_FROM_PROVIDER, DELETE_FROM_PROVIDER, FAILED Siempre null; esta API exige pago completo.
Show child attributes
Show child attributes