Recalculate ledger
Recalculates pricing, margins, and totals for all charges in the ledger without changing status.
Path parameters
idstringRequired
The ID of the ledger to recalculate.
Body
Represents a ledger in the billing system.
revisioninteger · int32Optional
idstringOptionalExample:
The unique identifier of the ledger.
BLE-1234-1234-1234-1234statusstring · enumOptionalPossible values:
Represents the various statuses a ledger can have in the billing system.
Responses
200
OK
application/json
Represents a ledger in the billing system.
revisioninteger · int32Optional
idstringOptionalExample:
The unique identifier of the ledger.
BLE-1234-1234-1234-1234statusstring · enumOptionalPossible values:
Represents the various statuses a ledger can have in the billing system.
403
Forbidden
application/json
404
Not Found
application/json
post/public/v1/billing/ledgers/{id}/recalculate
POST /public/v1/billing/ledgers/{id}/recalculate HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 1995
{
"audit": {
"created": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"updated": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"rating": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"error": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"review": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"generating": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"generated": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"queued": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"completed": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
}
},
"$meta": {
"omitted": [
"text"
]
},
"revision": 1,
"id": "BLE-1234-1234-1234-1234",
"journal": {
"revision": 1,
"id": "BJO-1234-1234",
"name": "29 Nov 2024 #1",
"dueDate": "2025-05-15T23:59:59+00:00"
},
"status": "Generated",
"authorization": {
"id": "text",
"name": "text",
"revision": 1,
"currency": "text"
},
"owner": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalId": "text"
},
"seller": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalId": "text"
},
"product": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalIds": {
"operations": "text",
"defaultErpItem": "text"
},
"status": "text"
},
"assignee": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
},
"price": {
"markup": 15.5,
"margin": 20,
"totalPP": 1000,
"totalBSP": 1200,
"currency": "text"
},
"processing": {
"total": 100,
"ready": 80,
"error": 5,
"split": 10,
"skipped": 5,
"ignored": 2
},
"error": {
"errorCode": "ERR-001",
"errorMessage": "Invalid billing data provided.",
"id": "12345",
"message": "Failed to process the billing entity due to missing data."
},
"backup": {
"status": "Pending",
"date": "2026-01-01T00:00:00.000Z"
}
}{
"audit": {
"created": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"updated": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"rating": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"error": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"review": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"generating": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"generated": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"queued": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"completed": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
}
},
"$meta": {
"omitted": [
"text"
]
},
"revision": 1,
"id": "BLE-1234-1234-1234-1234",
"journal": {
"revision": 1,
"id": "BJO-1234-1234",
"name": "29 Nov 2024 #1",
"dueDate": "2025-05-15T23:59:59+00:00"
},
"status": "Generated",
"authorization": {
"id": "text",
"name": "text",
"revision": 1,
"currency": "text"
},
"owner": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalId": "text"
},
"seller": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalId": "text"
},
"product": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1,
"externalIds": {
"operations": "text",
"defaultErpItem": "text"
},
"status": "text"
},
"assignee": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
},
"price": {
"markup": 15.5,
"margin": 20,
"totalPP": 1000,
"totalBSP": 1200,
"currency": "text"
},
"processing": {
"total": 100,
"ready": 80,
"error": 5,
"split": 10,
"skipped": 5,
"ignored": 2
},
"error": {
"errorCode": "ERR-001",
"errorMessage": "Invalid billing data provided.",
"id": "12345",
"message": "Failed to process the billing entity due to missing data."
},
"backup": {
"status": "Pending",
"date": "2026-01-01T00:00:00.000Z"
}
}Last updated
Was this helpful?