proposals
POST /v1/proposals
Draft a proposal. Nothing is sent until send.
စစ်မှန်ကြောင်း အတည်ပြုခြင်း
API သော့တစ်ခုကို bearer token အဖြစ် ပို့ပါ။ သော့တွင် agency.invoicing.manage ခွင့်ပြုချက် ပါရှိရမည်ဖြစ်ပြီး၊ ၎င်းမပါရှိသော သော့ကို 404 အစား 403 ဖြင့် ငြင်းပယ်ပါမည်။
သင့်အဖွဲ့အစည်း၏ id ထည့်သွင်းရမည့်နေရာ
ဤအစွန်အဖျား (endpoint) သည် org_id ကို မေးမြန်းချက် ကန့်သတ်ဘောင် (query parameter) အဖြစ် လက်ခံပါသည်။ ၎င်းကို ချန်လှပ်ထားပါက ခေါ်ဆိုမှုသည် သင်၏ ငှားရမ်းမှု လက်အောက်ခံသစ်ပင် (tenancy subtree) တစ်ခုလုံးကို လွှမ်းခြုံမည်ဖြစ်ပြီး၊ အဖွဲ့အစည်းတစ်ခုတည်းသို့ ကန့်သတ်ခေါ်ဆိုရန် ၎င်းကို ပေးပို့ပါ။
သင့်အဖွဲ့အစည်း id သည် သင်၏ ဒက်ရှ်ဘုတ်ရှိ API သော့များ မျက်နှာပြင်တွင်၊ သော့၏ ဘေး၌ ရှိပါသည်။ ၎င်းသည် သင်ပြုလုပ်သည့် ခေါ်ဆိုမှုတိုင်းတွင် တူညီသော id ဖြစ်ပါသည်။
စမ်းကြည့်ရန်
ထောင့်ချိတ်များအတွင်းရှိ မည်သည့်အရာကိုမဆို သင်၏ကိုယ်ပိုင်တန်ဖိုးများဖြင့် အစားထိုးပြီး သင့်ဒက်ရှ်ဘုတ်မှ သော့ချက်တစ်ခုဖြင့် key ကို အစားထိုးပါ။
curl -X POST https://api.zinndigital.com/v1/proposals \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'ဝင်ရောက်ပြီးပြီလား။ သင့်ဒက်ရှ်ဘုတ်ရှိ API ကွန်ဆိုးလ်တွင် သင့်၏ တကယ့်အဖွဲ့အစည်း ID နှင့် သင့်ကိုယ်ပိုင်သော့ချက်တို့ဖြင့် ဖြည့်သွင်းပေးပြီး တကယ့်တုံ့ပြန်ချက်ကို သင်မြင်နိုင်ရန် တိုက်ရိုက် API (live API) ကို အသုံးပြု၍ တောင်းဆိုမှုကို လုပ်ဆောင်ပေးပါသည်။ ဤအဆုံးသတ်အမှတ် (endpoint) ကို API ကွန်ဆိုးလ်တွင် ဖွင့်ပါ
အသေးစိတ်အချက်အလက်များ
Requires agency.invoicing.manage. The recipient may be ANY e-mail address — they need no account. Every price is integer minor units (§2.8); a decimal is a 422.
ကန့်သတ်ဘောင်များ
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
org_id (query) | Uuid | မဟုတ်ပါ | Which of your organizations is invoicing. Required only when you belong to more than one — otherwise it is inferred from your DIRECT membership, never from the subtree-expanded… |
တောင်းဆိုချက် ကိုယ်ထည်
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
title | string | မဟုတ်ပါ | — |
message | string | မဟုတ်ပါ | — |
terms | string | မဟုတ်ပါ | — |
currency | string | မဟုတ်ပါ | — |
valid_until | object | မဟုတ်ပါ | — |
agency_tax_rate_id | object | မဟုတ်ပါ | — |
recipient_name | string | မဟုတ်ပါ | — |
recipient_email | string | မဟုတ်ပါ | — |
recipient_company | string | မဟုတ်ပါ | — |
recipient_country | string | မဟုတ်ပါ | — |
recipient_tax_id | string | မဟုတ်ပါ | — |
recipient_locale | string | မဟုတ်ပါ | — |
source_request_id | object | မဟုတ်ပါ | — |
lines | ProposalLineInput[] | မဟုတ်ပါ | — |
တုံ့ပြန်ချက်
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
id | string | ဟုတ်ကဲ့ | — |
reference | string | ဟုတ်ကဲ့ | — |
status | ProposalStatus | ဟုတ်ကဲ့ | — |
title | string | ဟုတ်ကဲ့ | — |
currency | string | ဟုတ်ကဲ့ | — |
recipient_name | string | ဟုတ်ကဲ့ | — |
recipient_email | string | ဟုတ်ကဲ့ | — |
recipient_company | string | မဟုတ်ပါ | — |
revision | integer | ဟုတ်ကဲ့ | — |
valid_until | object | မဟုတ်ပါ | — |
sent_at | object | မဟုတ်ပါ | — |
decided_at | object | မဟုတ်ပါ | — |
paid_at | object | မဟုတ်ပါ | — |
board_id | object | မဟုတ်ပါ | — |
created_at | string | ဟုတ်ကဲ့ | — |
updated_at | string | မဟုတ်ပါ | — |
message | string | မဟုတ်ပါ | — |
terms | string | မဟုတ်ပါ | — |
agency_tax_rate_id | object | မဟုတ်ပါ | — |
recipient_country | string | မဟုတ်ပါ | — |
recipient_tax_id | string | မဟုတ်ပါ | — |
recipient_locale | string | မဟုတ်ပါ | — |
accepted_revision | object | မဟုတ်ပါ | — |
accepted_by_name | string | မဟုတ်ပါ | — |
source_request_id | object | မဟုတ်ပါ | — |
completed_at | object | မဟုတ်ပါ | — |
lines | ProposalLine[] | ဟုတ်ကဲ့ | — |
totals | ProposalTotals | ဟုတ်ကဲ့ | — |
invoice | ProposalInvoice | null | မဟုတ်ပါ | — |
events | ProposalEvent[] | ဟုတ်ကဲ့ | — |
editable | boolean | ဟုတ်ကဲ့ | — |
public_url | string | မဟုတ်ပါ | Returned ONCE, by send. Never readable again. |
ဤအမှတ်ဆက်မှ ပြန်ပေးနိုင်သော အမှားများ
401 · 403 · 422