proposals
PATCH /v1/proposals/{proposalId}
Edit a proposal before it is accepted.
စစ်မှန်ကြောင်း အတည်ပြုခြင်း
API သော့တစ်ခုကို bearer token အဖြစ် ပေးပို့ပါ။ ဤ အမှတ်အသားအဆုံး (endpoint) သည် သတ်မှတ်ချက်တွင် တိကျသော ခွင့်ပြုချက်တစ်ခုကို မဖော်ပြထားပါသဖြင့်၊ သင့်သော့ကို အနည်းဆုံး လိုအပ်သည်များသာ ပေးအပ်ပြီး မူလအခြေအနေကို ယူဆမည့်အစား တုံ့ပြန်မှုကို စစ်ဆေးပါ။
သင့်အဖွဲ့အစည်း၏ id ထည့်သွင်းရမည့်နေရာ
ဤအစွန်အဖျား (endpoint) သည် org_id ကို မေးမြန်းချက် ကန့်သတ်ဘောင် (query parameter) အဖြစ် လက်ခံပါသည်။ ၎င်းကို ချန်လှပ်ထားပါက ခေါ်ဆိုမှုသည် သင်၏ ငှားရမ်းမှု လက်အောက်ခံသစ်ပင် (tenancy subtree) တစ်ခုလုံးကို လွှမ်းခြုံမည်ဖြစ်ပြီး၊ အဖွဲ့အစည်းတစ်ခုတည်းသို့ ကန့်သတ်ခေါ်ဆိုရန် ၎င်းကို ပေးပို့ပါ။
သင့်အဖွဲ့အစည်း id သည် သင်၏ ဒက်ရှ်ဘုတ်ရှိ API သော့များ မျက်နှာပြင်တွင်၊ သော့၏ ဘေး၌ ရှိပါသည်။ ၎င်းသည် သင်ပြုလုပ်သည့် ခေါ်ဆိုမှုတိုင်းတွင် တူညီသော id ဖြစ်ပါသည်။
စမ်းကြည့်ရန်
ထောင့်ချိတ်များအတွင်းရှိ မည်သည့်အရာကိုမဆို သင်၏ကိုယ်ပိုင်တန်ဖိုးများဖြင့် အစားထိုးပြီး သင့်ဒက်ရှ်ဘုတ်မှ သော့ချက်တစ်ခုဖြင့် key ကို အစားထိုးပါ။
curl -X PATCH https://api.zinndigital.com/v1/proposals/{proposalId} \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'ဝင်ရောက်ပြီးပြီလား။ သင့်ဒက်ရှ်ဘုတ်ရှိ API ကွန်ဆိုးလ်တွင် သင့်၏ တကယ့်အဖွဲ့အစည်း ID နှင့် သင့်ကိုယ်ပိုင်သော့ချက်တို့ဖြင့် ဖြည့်သွင်းပေးပြီး တကယ့်တုံ့ပြန်ချက်ကို သင်မြင်နိုင်ရန် တိုက်ရိုက် API (live API) ကို အသုံးပြု၍ တောင်းဆိုမှုကို လုပ်ဆောင်ပေးပါသည်။ ဤအဆုံးသတ်အမှတ် (endpoint) ကို API ကွန်ဆိုးလ်တွင် ဖွင့်ပါ
အသေးစိတ်အချက်အလက်များ
⛔ Refused (422) once accepted — the accepted revision is the agreement. Editing a SENT proposal does not change what the recipient reads until it is sent again, which issues a new revision and replaces their link.
ကန့်သတ်ဘောင်များ
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
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… |
တောင်းဆိုချက် ကိုယ်ထည်
| နာမည် | အမျိုးအစား | လိုအပ်သည် | ဘာလဲဆိုတာ |
|---|---|---|---|
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 · 404 · 422