proposals
POST /v1/proposals/{proposalId}/send
Issue the current edits as a new revision and e-mail the recipient a fresh link.
စစ်မှန်ကြောင်း အတည်ပြုခြင်း
API သော့တစ်ခုကို bearer token အဖြစ် ပေးပို့ပါ။ ဤ အမှတ်အသားအဆုံး (endpoint) သည် သတ်မှတ်ချက်တွင် တိကျသော ခွင့်ပြုချက်တစ်ခုကို မဖော်ပြထားပါသဖြင့်၊ သင့်သော့ကို အနည်းဆုံး လိုအပ်သည်များသာ ပေးအပ်ပြီး မူလအခြေအနေကို ယူဆမည့်အစား တုံ့ပြန်မှုကို စစ်ဆေးပါ။
သင့်အဖွဲ့အစည်း၏ id ထည့်သွင်းရမည့်နေရာ
ဤအစွန်အဖျား (endpoint) သည် org_id ကို မေးမြန်းချက် ကန့်သတ်ဘောင် (query parameter) အဖြစ် လက်ခံပါသည်။ ၎င်းကို ချန်လှပ်ထားပါက ခေါ်ဆိုမှုသည် သင်၏ ငှားရမ်းမှု လက်အောက်ခံသစ်ပင် (tenancy subtree) တစ်ခုလုံးကို လွှမ်းခြုံမည်ဖြစ်ပြီး၊ အဖွဲ့အစည်းတစ်ခုတည်းသို့ ကန့်သတ်ခေါ်ဆိုရန် ၎င်းကို ပေးပို့ပါ။
သင့်အဖွဲ့အစည်း id သည် သင်၏ ဒက်ရှ်ဘုတ်ရှိ API သော့များ မျက်နှာပြင်တွင်၊ သော့၏ ဘေး၌ ရှိပါသည်။ ၎င်းသည် သင်ပြုလုပ်သည့် ခေါ်ဆိုမှုတိုင်းတွင် တူညီသော id ဖြစ်ပါသည်။
စမ်းကြည့်ရန်
ထောင့်ချိတ်များအတွင်းရှိ မည်သည့်အရာကိုမဆို သင်၏ကိုယ်ပိုင်တန်ဖိုးများဖြင့် အစားထိုးပြီး သင့်ဒက်ရှ်ဘုတ်မှ သော့ချက်တစ်ခုဖြင့် key ကို အစားထိုးပါ။
curl -X POST https://api.zinndigital.com/v1/proposals/{proposalId}/send \
-H "Authorization: Bearer zdk_live_…"ဝင်ရောက်ပြီးပြီလား။ သင့်ဒက်ရှ်ဘုတ်ရှိ API ကွန်ဆိုးလ်တွင် သင့်၏ တကယ့်အဖွဲ့အစည်း ID နှင့် သင့်ကိုယ်ပိုင်သော့ချက်တို့ဖြင့် ဖြည့်သွင်းပေးပြီး တကယ့်တုံ့ပြန်ချက်ကို သင်မြင်နိုင်ရန် တိုက်ရိုက် API (live API) ကို အသုံးပြု၍ တောင်းဆိုမှုကို လုပ်ဆောင်ပေးပါသည်။ ဤအဆုံးသတ်အမှတ် (endpoint) ကို API ကွန်ဆိုးလ်တွင် ဖွင့်ပါ
အသေးစိတ်အချက်အလက်များ
The link is returned ONCE as public_url and is never readable again (only its digest is stored). The previous link stops working. If the mail provider refuses, nothing is marked sent (503).
ကန့်သတ်ဘောင်များ
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
proposalId (path) | string | ဟုတ်ကဲ့ | — |
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… |
တုံ့ပြန်ချက်
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
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 · 404 · 409 · 503