DealPOS API (3.1.0)

Welcome Developer

This page lists the reference documentation for DealPOS APIs. For guides and tutorials.

Download OpenAPI description
Overview
URL https://www.dealpos.com
Customer Support info@dealpos.com
License
Languages
Servers
Production Server
https://{subdomain}/api/v3/

Token

Operations related to authentication tokens

Operations

Category

Operations related to category, including create, get, etc

Operations

Product

Operations related to product, including create, get, etc

Operations

Variant

Operations related to variant, including create, get, etc

Operations

Serial

Operation related to Serial product type

Operations

Estimate

Operations related to estimate, including create, get, etc

Operations

Sales Order

Operations related to sales order, including create, get, etc

Operations

Invoice

Operations related to invoice, including create, get, etc

Operations

Shift

Operation related to shift, including create, get, etc

Operations

Report

Operations related to report page, including create, get, etc

Operations

Customer

Operations related to customer data, including create, get, etc

Operations

Comment

Operations related to comment (Contact Feedback), including create, get, etc

Operations

Supplier

Operations related to supplier data, including create, get, etc

Operations

Invoice Payment

Operations related to invoice payment, including create, get, etc

Operations

Received by Outlet

Request

Also available as HTTP POST (endpoint: /api/v3/Payment/Invoice/p)


Invoice Payment Received By Outlet

Required Group Role: "Payment" - "VIEW"

Bodyapplication/json
Fromstringrequired

From date

Tostringrequired

To date

curl -i -X GET \
  https://subdomain.dealpos.net/api/v3/Payment/Invoice \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "From": "2023-01-01",
    "To": "2023-01-31"
  }'

Responses

Bodyapplication/jsonArray [
Outletstring

the outlet of the transaction

PaymentsArray of objects
]
Response
application/json
[ { "Outlet": "Outlet1", "Payments": [ … ] }, { "Outlet": "Outlet2", "Payments": [ … ] } ]

Add Payment

Request

Terminology Changes

StateFilter, will be changed into UnpaidValidation in the upcoming update, the old one will remain works.

Add Payment in invoice

You must have "ADD" role in "Payment" Module OR "EDIT" role in "Global" Module

Bodyapplication/json
One of:
Outletstringrequired

Outlet of transaction

Example: "Outlet1"
Numberstringrequired

Invoice transaction number

Example: "20.04.00019"
PaymentsArray of objects
Example: [{"Date":"2023-01-01","Amount":100,"Method":"Cash","Note":""},{"Date":"2023-01-01","Amount":100,"Method":"Debit - Outlet Outlet1","Note":""}]
UnpaidValidationboolean

If true, returns 409 when there's an existing payment

Default false
curl -i -X POST \
  https://subdomain.dealpos.net/api/v3/Payment/Invoice \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Outlet": "Outlet1",
    "Number": "20.04.00019",
    "Payments": [
      {
        "Date": "2023-01-01",
        "Amount": 100,
        "Method": "Cash",
        "Note": ""
      },
      {
        "Date": "2023-01-01",
        "Amount": 100,
        "Method": "Debit - Outlet Outlet1",
        "Note": ""
      }
    ]
  }'

Responses

Bodyapplication/json
Messagestring

Invoice has been paid

Response
application/json
{ "Message": "Invoice Number 20.04.00019 has successfully completed a Paid" }

Delete Payment

Request

Delete Payment in invoice

You must have "Edit" role in "Payment" Module

Bodyapplication/json
One of:
Outletstringrequired

Outlet Name that you want to delete

Example: "Outlet1"
Numberstringrequired

Invoice number that you want to delete

Example: "21.10.00001"
curl -i -X DELETE \
  https://subdomain.dealpos.net/api/v3/Payment/Invoice \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Outlet": "Outlet1",
    "Number": "21.10.00001"
  }'

Responses

Bodyapplication/json
Messagestring
Response
application/json
{ "Message": "Invoice Number .21.10.00001 has successfully deleted" }

Add Payment (Full Payment)

Request

Terminology Changes

StateFilter, will be changed into UnpaidValidation in the upcoming update, the old one will remain works.

This endpoint is a fractions from API/V3/Payment/Invoice. In This endpoint, you will not need to fill the exact payment amount in order to fill the entire payments (fully paid). You will only need to fill the Amount to 0 (zero). Please see the request example attached.

You must have "ADD" role in "Payment" Module OR "EDIT" role in "Global" Module

Bodyapplication/json
One of:
Numberstringrequired

Invoice transaction number

Example: "20.04.00019"
Outletstringrequired

Outlet of transaction

Example: "Outlet Name"
PaymentsArray of objects
Example: [{"Date":"2020-04-01","Amount":0,"Method":"Cash","Note":""}]
UnpaidValidationboolean

If true, returns 409 when there's an existing payment

Default false
curl -i -X POST \
  https://subdomain.dealpos.net/api/v3/Payment/Invoice/AddPaymentFull \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Number": "20.04.00019",
    "Outlet": "Outlet Name",
    "Payments": [
      {
        "Date": "2020-04-01",
        "Amount": 0,
        "Method": "Cash",
        "Note": ""
      }
    ],
    "UnpaidValidation": false
  }'

Responses

Bodyapplication/json
Messagestring

Invoice has been paid

Response
application/json
{ "Message": "Invoice Number 20.04.00019 has successfully completed a Paid" }

Bill Payment

Operations related to bill payment, including create, get, etc

Operations

Invoice Write Off

Operations related to invoice write off, including create, get, etc

Operations

Inventory

Operations related to inventory, including create, get, etc

Operations

Inventory Log

Operations related to inventory log, including create, get, etc

Operations

Inventory Adjustment

Operations related to inventory adjustment, including create, get, etc

Operations

Bill

Operations related to bill, including create, get, etc

Operations

OutboundLogistic

Operations related to outbound logistic, including create, get, etc

Operations

InboundLogistic

Operations related to inbound logistic, including create, get, etc

Operations

TransferOrder

Operations related to transfer order, including create, get, etc

Operations

Picklist

Operations related to picklist, including create, get, etc

Operations

Prepaid Package

Operations related to prepaid package, including create, get, etc

Operations

Promotion Coupon

Operations related to promotion coupon, including create, get, etc

Operations

Promotion Event

Operations related to promotion event, including create, get, etc

Operations

Outlet

Operations related to outlet, including create, get, etc

Operations

Outlet Price

Operations related to outlet price, including create, get, etc

Operations

Loyalty Point

Operations related to loyalty point, including create, get, etc

Operations

Notification

Operations related to notification, including create, get, etc

Operations

Payment Method

Operations related to payment method, including create, get, etc

Operations

Invoice Write Off Option

Operations related to invoice write off option, including create, get, etc

Operations

Tax

Operations related to tax, including create, get, etc

Operations

Logistics Service

Operations related to logistics service, including create, get, etc

Operations

Midtrans Payment Gateway

Operations related to Midtrans Payment Gateway, including create, get, etc

Operations

Apps

Operations related to Apps, including create, get, etc

Operations

Barcode

Operations related to barcode, including create, get, etc

Operations