Produk

Produk adalah katalog yang bisa dipakai ulang sebagai item invoice.

GET/v1/products

Mengambil daftar produk organisasi Anda

curl -X GET "https://tagihandigital.com/api/v1/products" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA"

Contoh respons

200 — Daftar produk

[
  {
    "id": "prd_123",
    "name": "Jasa Konsultasi",
    "description": null,
    "unitPrice": "150000",
    "unit": "jam",
    "taxPercent": "11",
    "sku": null,
    "createdAt": "2026-09-09T02:11:00.000Z",
    "updatedAt": "2026-09-09T02:11:00.000Z"
  }
]

Kemungkinan error

UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.

POST/v1/products

Membuat produk baru

Parameter body

Parameter	Tipe	Wajib	Keterangan
name	string	Ya	Nama produk.
description	string	Tidak	Deskripsi produk.
unitPrice	number	Ya	Harga satuan.
unit	string	Tidak	Satuan, mis. jam, pcs.
taxPercent	number	Tidak	Persentase pajak default untuk item ini.
sku	string	Tidak	Kode SKU internal.

curl -X POST "https://tagihandigital.com/api/v1/products" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Jasa Konsultasi",
  "unitPrice": 150000,
  "unit": "jam"
}'

Contoh respons

201 — Produk dibuat

{
  "id": "prd_123",
  "name": "Jasa Konsultasi",
  "description": null,
  "unitPrice": "150000",
  "unit": "jam",
  "taxPercent": null,
  "sku": null,
  "createdAt": "2026-09-09T02:11:00.000Z",
  "updatedAt": "2026-09-09T02:11:00.000Z"
}

Kemungkinan error

VALIDATION_ERROR (400) — Payload tidak lolos validasi. Field yang bermasalah dirinci pada `issues`.
UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.

GET/v1/products/{id}

Mengambil satu produk

curl -X GET "https://tagihandigital.com/api/v1/products/{id}" \
  -H "Authorization: Bearer td_live_API_KEY_ANDA"

Contoh respons

200 — Produk ditemukan

{
  "id": "prd_123",
  "name": "Jasa Konsultasi",
  "description": null,
  "unitPrice": "150000",
  "unit": "jam",
  "taxPercent": "11",
  "sku": null,
  "createdAt": "2026-09-09T02:11:00.000Z",
  "updatedAt": "2026-09-09T02:11:00.000Z"
}

Kemungkinan error

PRODUCT_NOT_FOUND (404) — Produk tidak ada di organisasi pemilik key.
UNAUTHORIZED (401) — Header Authorization hilang, API key salah, atau key sudah dicabut.