agency-time

POST `/v1/agency/time/checkout-bills/{billId}/void`

Withdraw an unpaid checkout bill; its hours return to the unbilled pool.

அங்கீகாரம்

பியரர் டோக்கனாக (bearer token) ஒரு API விசையை அனுப்பவும். அந்த விசை agency.time.manage அனுமதியைக் கொண்டிருக்க வேண்டும்; அது இல்லாத விசை 404 அல்ல, 403 குறியீட்டுடன் மறுக்கப்படும்.

உங்கள் அமைப்பு ஐடி எங்கு செல்ல வேண்டும்

இந்த எண்ட்ஸ்பாயிண்ட் JSON பாடியில் உள்ள ஒரு புலமாக org_id-ஐ எடுத்துக்கொள்கிறது.

உங்கள் நிறுவன ஐடி உங்கள் டாஷ்போர்டில் உள்ள API விசைகள் திரையில், விசைக்கு அருகிலேயே உள்ளது. நீங்கள் செய்யும் ஒவ்வொரு அழைப்பிலும் இதுவே ஒரே ஐடி ஆகும்.

முயன்று பார்

கோண அடைப்புக்குறிகளில் உள்ள எதையும் உங்கள் சொந்த மதிப்புகளுடன் மாற்றவும், மேலும் விசை பிளேஸ்ஹோல்டரை உங்கள் டாஷ்போர்டில் உள்ள விசையுடன் மாற்றவும்.

curl -X POST https://api.zinndigital.com/v1/agency/time/checkout-bills/{billId}/void \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "reason": <string> }'

உள்நுழைந்துள்ளீர்களா? உங்கள் டேஷ்போர்டில் உள்ள ஏபிஐ கன்சோல் உங்கள் உண்மையான நிறுவன ஐடி மற்றும் உங்கள் சொந்த சாவியை நிரப்புகிறது, மேலும் நேரலை ஏபிஐக்கு எதிராக கோரிக்கையை இயக்குகிறது, இதனால் நீங்கள் உண்மையான பதிலைக் காண முடியும். இந்த எண்ட்மார்க்கை ஏபிஐ கன்சோலில் திறக்கவும்

விவரங்கள்

The pay link stops working at once and the time the bill carried is released immediately, so it can be billed again. A paid bill cannot be voided. Requires agency.time.manage and the billing.entitlement.manage staff permission (docs/670 §3).

அளவுருக்கள்

பெயர்	வகை	தேவைப்படுகிறது	அது என்ன
`billId (path)`	`string`	ஆம்	—

கோரிக்கை உடல்

பெயர்	வகை	தேவைப்படுகிறது	அது என்ன
`reason`	`string`	ஆம்	—
`org_id`	`string`	இல்லை	—

பதில்

பெயர்	வகை	தேவைப்படுகிறது	அது என்ன
`id`	`string`	ஆம்	—
`reference`	`string`	ஆம்	—
`status`	`string<draft, sent, paid, void>`	ஆம்	—
`currency`	`string`	ஆம்	—
`subtotal_minor`	`integer`	ஆம்	—
`tax_minor`	`integer`	ஆம்	—
`total_minor`	`integer`	ஆம்	—
`recipient_email`	`string`	இல்லை	—
`recipient_country`	`string`	இல்லை	—
`sent_at`	`string`	இல்லை	—
`paid_at`	`string`	இல்லை	—
`voided_at`	`string`	இல்லை	—
`pay_url`	`string`	ஆம்	The public page the recipient pays this bill on.

இந்த எண்ட்ஸ்பாயிண்ட் திரும்ப அனுப்பக்கூடிய பிழைகள்

401 · 403 · 404 · 422

POST /v1/agency/time/checkout-bills/{billId}/void