Overdue

The Overdue resource offers endpoints that can be used to upload/retrieve overdue configurations.

Overdue APIs

Upload Overdue XML

Uploads the overdue configuration in XML format.

HTTP Request

POST http://127.0.0.1:8080/1.0/kb/overdue/xml

Example Request:

curl -v \
    -X POST \
    -u admin:password \
    -H "X-Killbill-ApiKey: bob" \
    -H "X-Killbill-ApiSecret: lazar" \
    -H "Content-Type: text/xml" \
    -H "Accept: application/json" \
    -H "X-Killbill-CreatedBy: demo" \
    -H "X-Killbill-Reason: demo" \
    -H "X-Killbill-Comment: demo" \
    -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><overdueConfig> ...' \
    "http://127.0.0.1:8080/1.0/kb/overdue/xml"
import org.killbill.billing.client.api.gen.OverdueApi;

protected OverdueApi overdueApi;

String overdueXML = "<overdueConfig>...</overdueConfig>";
overdueApi.uploadOverdueConfigXml(overdueXML, requestOptions);
TODO
TODO
TODO
TODO

Request Body

The complete overdue configuration in XML format.

Query Parameters

None

Response

If successful, returns a status code of 201 and an empty body.

Upload Overdue JSON

Uploads the overdue configuration in JSON format.

HTTP Request

POST http://127.0.0.1:8080/1.0/kb/overdue/

Example Request:

curl -v \
    -X POST \
    -u admin:password \
    -H "X-Killbill-ApiKey: bob" \
    -H "X-Killbill-ApiSecret: lazar" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "X-Killbill-CreatedBy: demo" \
    -H "X-Killbill-Reason: demo" \
    -H "X-Killbill-Comment: demo" \
    -d 'json body' \
    "http://127.0.0.1:8080/1.0/kb/overdue/" 
import org.killbill.billing.client.api.gen.OverdueApi;

protected OverdueApi overdueApi;

Overdue overdue = new Overdue(); //construct overdue object appropriately
overdueApi.uploadOverdueConfigJson(overdue, requestOptions);
TODO
TODO
TODO
TODO

Request Body

The complete overdue configuration in JSON format.

Query Parameters

None

Response

If successful, returns a status code of 201 and an empty body.

Retrieve Overdue XML

Retrieves the overdue configuration in XML format.

HTTP Request

GET http://127.0.0.1:8080/1.0/kb/overdue/xml

Example Request:

curl -v \
    -u admin:password \
    -H "X-Killbill-ApiKey: bob" \
    -H "X-Killbill-ApiSecret: lazar" \
    -H "Accept: text/xml" \
    "http://localhost:8080/1.0/kb/overdue/xml"  

import org.killbill.billing.client.api.gen.OverdueApi;

protected OverdueApi overdueApi;

String overdueXml = overdueApi.getOverdueConfigXml(requestOptions);
TODO
TODO
TODO
TODO

Example Response: xml <overdueConfig> <accountOverdueStates> <initialReevaluationInterval> <unit>DAYS</unit> <number>10</number> </initialReevaluationInterval> <state name="CANCELLATION"> <condition> <timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> <unit>DAYS</unit> <number>21</number> </timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> </condition> <externalMessage>Reached CANCELATION</externalMessage> <blockChanges>false</blockChanges> <disableEntitlementAndChangesBlocked>false</disableEntitlementAndChangesBlocked> <subscriptionCancellationPolicy>END_OF_TERM</subscriptionCancellationPolicy> <isClearState>false</isClearState> </state> <state name="BLOCKED"> <condition> <timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> <unit>DAYS</unit> <number>14</number> </timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> </condition> <externalMessage>Reached BLOCKED</externalMessage> <blockChanges>true</blockChanges> <disableEntitlementAndChangesBlocked>false</disableEntitlementAndChangesBlocked> <subscriptionCancellationPolicy>NONE</subscriptionCancellationPolicy> <isClearState>false</isClearState> <autoReevaluationInterval> <unit>DAYS</unit> <number>7</number> </autoReevaluationInterval> </state> <state name="WARNING"> <condition> <timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> <unit>DAYS</unit> <number>10</number> </timeSinceEarliestUnpaidInvoiceEqualsOrExceeds> </condition> <externalMessage>Reached WARNING</externalMessage> <blockChanges>true</blockChanges> <disableEntitlementAndChangesBlocked>true</disableEntitlementAndChangesBlocked> <subscriptionCancellationPolicy>NONE</subscriptionCancellationPolicy> <isClearState>false</isClearState> <autoReevaluationInterval> <unit>DAYS</unit> <number>4</number> </autoReevaluationInterval> </state> </accountOverdueStates> </overdueConfig>

Query Parameters

None

Response

If successful, returns a status code of 201 and the overdue configuration in XML format.

Retrieve Overdue JSON

Retrieves the overdue configuration in JSON format.

HTTP Request

GET http://127.0.0.1:8080/1.0/kb/overdue/

Example Request:

curl -v \
    -u admin:password \
    -H "X-Killbill-ApiKey: bob" \
    -H "X-Killbill-ApiSecret: lazar" \
    -H "Accept: application/json" \
    "http://127.0.0.1:8080/1.0/kb/overdue"      
import org.killbill.billing.client.api.gen.OverdueApi;

protected OverdueApi overdueApi;

Overdue overdueJson = overdueApi.getOverdueConfigJson(requestOptions);
TODO
TODO
TODO
TODO

Example Response: json { "initialReevaluationInterval": 10, "overdueStates": [ { "name": "CANCELLATION", "isClearState": false, "condition": { "timeSinceEarliestUnpaidInvoiceEqualsOrExceeds": { "unit": "DAYS", "number": 21 }, "controlTagInclusion": null, "controlTagExclusion": null, "numberOfUnpaidInvoicesEqualsOrExceeds": null, "responseForLastFailedPayment": null, "totalUnpaidInvoiceBalanceEqualsOrExceeds": null }, "externalMessage": "Reached CANCELATION", "isBlockChanges": false, "isDisableEntitlement": false, "subscriptionCancellationPolicy": "END_OF_TERM", "autoReevaluationIntervalDays": null }, { "name": "BLOCKED", "isClearState": false, "condition": { "timeSinceEarliestUnpaidInvoiceEqualsOrExceeds": { "unit": "DAYS", "number": 14 }, "controlTagInclusion": null, "controlTagExclusion": null, "numberOfUnpaidInvoicesEqualsOrExceeds": null, "responseForLastFailedPayment": null, "totalUnpaidInvoiceBalanceEqualsOrExceeds": null }, "externalMessage": "Reached BLOCKED", "isBlockChanges": true, "isDisableEntitlement": false, "subscriptionCancellationPolicy": "NONE", "autoReevaluationIntervalDays": 7 }, { "name": "WARNING", "isClearState": false, "condition": { "timeSinceEarliestUnpaidInvoiceEqualsOrExceeds": { "unit": "DAYS", "number": 10 }, "controlTagInclusion": null, "controlTagExclusion": null, "numberOfUnpaidInvoicesEqualsOrExceeds": null, "responseForLastFailedPayment": null, "totalUnpaidInvoiceBalanceEqualsOrExceeds": null }, "externalMessage": "Reached WARNING", "isBlockChanges": true, "isDisableEntitlement": true, "subscriptionCancellationPolicy": "NONE", "autoReevaluationIntervalDays": 4 } ] }

Query Parameters

None

Response

If successful, returns a status code of 201 and the overdue configuration in JSON format.