Push Bill

POST

https://supplierapi-demo.bill24.net/bill/push

Billers/Businesses can push bills through this interface to Bill24 proxy/host. After completed this step your customer can pay via Bank channels.

NOTE

Bill Status:

draft = create draft invoice in bill gateway system and not available to pay.

approve = create approval invoice, customer can pay but not send notification.

notify = create approval invoice and send notification to customer.

Bill Types:

1 = Quick Bill (Bill without customer).

2 = Sale Bill (Bill with specific customer).

3 = Purchase Bill.

4 = Recurring Bil.

Request

Header Params

string

required

Example:

application/json

Content-Type

string

required

Example:

application/json

token

string

required

Example:

1603aa00dcc4426ba83298341bab126b

Body Params application/json

data

array [object {16}]

required

status

string

optional

Bill status

• draft: create draft invoice in
bill gateway system and not
available to pay

• approve: create approval
invoice, customer can pay
but not send notification

• notify: create approval
invoice and send notification
to customer

due_date

string

optional

Bill due date

description

string

optional

Bill description

org_code

string

optional

PK or unique code for sync purpose

customer_sync_code

string

optional

Customer sync code

currency_id

string

optional

The currency code

org_token

string

optional

ext__discount

string

optional

Discount price, it can be a value or percentage Example: "<span style='color:red'ext__discount": "1%" or “1”

ext__details

array [object {4}]

optional

Bill items

• item_name: item description

• quantity

• price

• amount

ext__attachment

string

optional

Bill attachment

total_amount

integer

optional

Bill amount

sync_code

string

optional

PK or unique code for sync purpose

ext__tax

string

optional

VAT Bill

ext__delivery

string

optional

Delivery price

bill_date

string

optional

Bill date

bill_type

string

optional

Bill Type

• 1: Quick Bill (Bill without customer)

• 2: Sale Bill (Bill with specific customer)

• 3: Purchase Bill • 4: Recurring Bill

Example

{
  "data": [
    {
      "status": "pending",
      "due_date": "2024-12-31",
      "description": "Buy something.",
      "org_code": "INVV001",
      "customer_sync_code": "099003",
      "currency_id": "USD",
      "org_token": "",
      "ext__discount": "1%",
      "ext__details": [
        {
          "item_name": "Note book",
          "price": 10.0,
          "amount": 10.0,
          "quantity": 1
        }
      ],
      "ext__attachment": "string",
      "total_amount": 10.0,
      "sync_code": "INVV001",
      "ext__tax": "",
      "ext__delivery": "0",
      "bill_date": "2024-02-26",
      "bill_type": "2"
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://supplierapi-demo.bill24.net/bill/push' \
--header 'Accept: application/json' \
--header 'token: 1603aa00dcc4426ba83298341bab126b' \
--header 'Content-Type: application/json' \
--data-raw '{
  "data": [
    {
      "status": "pending",
      "due_date": "2024-12-31",
      "description": "Buy something.",
      "org_code": "INVV001",
      "customer_sync_code": "099003",
      "currency_id": "USD",
      "org_token": "",
      "ext__discount": "1%",
      "ext__details": [
        {
          "item_name": "Note book",
          "price": 10.0,
          "amount": 10.0,
          "quantity": 1
        }
      ],
      "ext__attachment": "string",
      "total_amount": 10.0,
      "sync_code": "INVV001",
      "ext__tax": "",
      "ext__delivery": "0",
      "bill_date": "2024-02-26",
      "bill_type": "2"
    }
  ]
}'

Responses

🟢200OK

application/json

Body

string

optional

code

string

optional

operation

string

optional

note

string

optional

status

string

optional

completed

boolean

optional

created_host

string

optional

start_date

null

optional

end_date

null

optional

result

null

optional

total_record

string

optional

created_date

string

optional

Example

{
    "id": "SD4N0C4l",
    "code": "2da3c91e-e7cd-427c-b987-154a9793b271",
    "operation": "bll.push",
    "note": "",
    "status": "ready",
    "completed": false,
    "created_host": "None",
    "start_date": null,
    "end_date": null,
    "result": null,
    "total_record": "1",
    "created_date": "2024-02-14T14:16:31.081235"
}

Modified at 2024-02-15 09:47:09

Push Customer

Get Queue