import {z} from 'zod' export type GetApiSuppliersIdArgs = {id: number, limit?: number | undefined, offset?: number | undefined, order_by?: string | undefined, dir?: ('asc' | 'desc') | undefined, return_object?: ('limited' | 'shallow' | 'none') | undefined, filter?: string | undefined}; export type GetApiSuppliersIdOptions = {baseUrl?: string | undefined, OAuth2AccessCode?: string | undefined, fetch?: typeof fetch | undefined}; export const userSimple = z.object({"avatar-thumb-url": z.string().optional(), "created-at": z.string().optional(), email: z.string(), "employee-number": z.string().optional(), firstname: z.string(), fullname: z.string().optional(), id: z.number().int().optional(), lastname: z.string(), login: z.string(), "salesforce-id": z.string(), "updated-at": z.string().optional()}); export const currency = z.object({code: z.string(), decimals: z.number().int().optional(), enabled: z.boolean().optional(), id: z.number().int().optional(), name: z.string(), symbol: z.string().optional()}); export const businessGroup = z.object({"created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), id: z.number().int().optional(), name: z.string(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const country = z.object({code: z.string(), "created-at": z.string().optional(), id: z.number().int().optional(), name: z.string().optional(), "updated-at": z.string().optional()}); export const purpose = z.object({"created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), kind: z.string(), name: z.string(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const address: z.ZodType
= z.object({active: z.boolean().optional(), attention: z.string().optional(), "business-group-name": z.string().optional(), city: z.string(), "content-groups": z.array(businessGroup).optional(), country: country, "created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), "local-tax-number": z.string(), "location-code": z.string().optional(), name: z.string().optional(), "postal-code": z.string(), purposes: z.array(purpose).optional(), state: z.string().optional(), "state-iso-code": z.string().optional(), street1: z.string(), street2: z.string().optional(), street3: z.string().optional(), street4: z.string().optional(), "tax-registrations": z.array(z.lazy(() => address)).optional(), type: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "vat-country": country.optional(), "vat-number": z.string().optional()}); export const phoneNumber = z.object({"area-code": z.string().optional(), "country-code": z.string().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), extension: z.string().optional(), id: z.number().int().optional(), number: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const contact = z.object({active: z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), email: z.string().optional(), id: z.number().int().optional(), "name-additional": z.string().optional(), "name-family": z.string().optional(), "name-fullname": z.string().optional(), "name-given": z.string().optional(), "name-prefix": z.string().optional(), "name-suffix": z.string().optional(), notes: z.string().optional(), "phone-fax": phoneNumber.optional(), "phone-mobile": phoneNumber.optional(), "phone-work": phoneNumber.optional(), photo: z.string().optional(), purposes: z.array(purpose).optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const accountType = z.object({active: z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), currency: currency, "dynamic-flag": z.boolean().optional(), id: z.number().int().optional(), "legal-entity-name": z.string().optional(), name: z.string(), "primary-address": address.optional(), "primary-contact": contact.optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const commodity: z.ZodType = z.object({active: z.boolean().optional(), category: z.enum(["goods", "services"]).optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), deductibility: z.enum(["fully_deductible", "partially_deductible", "not_deductible"]).optional(), id: z.number().int().optional(), "imported-from-taxonomy": z.boolean().optional(), name: z.string(), parent: z.lazy(() => commodity.optional()), preferred: z.enum(["Yes", "No", "Automatic", "Always", "Never"]).optional(), subcategory: z.enum(["raw_materials", "investment_goods", "services_exceptions"]).optional(), "translated-name": z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const customerSupportContact = z.object({active: z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), email: z.string().optional(), fullname: z.string().optional(), id: z.number().int().optional(), purposes: z.array(purpose).optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), user: userSimple.optional(), "user-id": z.number().int()}); export const diversitySubcategory = z.object({active: z.boolean().optional(), category: z.string().optional(), code: z.string(), "created-at": z.string().optional(), designation: z.string().optional(), id: z.number().int().optional(), "updated-at": z.string().optional()}); export const diversityCategory = z.object({active: z.boolean().optional(), category: z.string().optional(), code: z.string(), "created-at": z.string().optional(), "created-by": userSimple.optional(), "diversity-subcategories": z.array(diversitySubcategory).optional(), id: z.number().int().optional(), "parent-category": z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const diversityCertificationAgency = z.object({code: z.string().optional(), "created-at": z.string().optional(), id: z.number().int().optional(), name: z.string().optional(), "region-type": z.string().optional(), "updated-at": z.string().optional()}); export const simDiversityCertificateArtifact = z.object({agency: diversityCertificationAgency.optional(), "agency-id": z.number().int().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), "effective-date": z.string().optional(), "expiry-date": z.string().optional(), id: z.number().int().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const diversityAssociation = z.object({country: country.optional(), "country-id": z.number().int(), "created-at": z.string().optional(), "created-by": userSimple.optional(), "diversity-category": diversityCategory.optional(), "diversity-category-id": z.number().int(), "diversity-subcategory": diversitySubcategory.optional(), "diversity-subcategory-id": z.number().int(), id: z.number().int().optional(), "sim-diversity-certificate-artifacts": z.array(simDiversityCertificateArtifact).optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const enterprise = z.object({"active-flag": z.boolean().optional(), code: z.string(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), id: z.number().int().optional(), name: z.string(), "system-flag": z.boolean().optional(), "tax-coding-enabled": z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "vendor-remit-to-required": z.string().optional()}); export const integration = z.object({"business-object": z.string(), code: z.string(), "created-at": z.string().optional(), "created-by": userSimple.optional(), direction: z.enum(["to_coupa", "from_coupa"]), "end-system": z.string(), "end-system-type": z.enum(["payroll", "erp", "hr", "third_party_partner", "third_party_vendor", "other", "internal"]), id: z.number().int().optional(), "integration-type": z.enum(["flat_file", "api", "corporate_credit_card_file", "json", "xml", "original_format"]).optional(), name: z.string(), standard: z.boolean().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const integrationContact: z.ZodType = z.object({"contact-alert-type": z.enum(["Technical", "Functional", "Both"]), contactable: z.lazy(() => integrationContact.optional()), "contactable-id": z.number().int(), "contactable-type": z.enum(["User", "UserGroup", "ApprovalGroup", "Supplier", "SupplierUser"]), "created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), integration: integration.optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const warehouseLocation = z.object({active: z.boolean().optional(), aisle: z.string(), bin: z.string().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), label: z.string().optional(), level: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "warehouse-id": z.number().int().optional(), "warehouse-name": z.string().optional()}); export const warehouseType = z.object({"created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string(), id: z.number().int().optional(), name: z.string(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const warehouse = z.object({"active-flag": z.boolean().optional(), address: address, "created-at": z.string().optional(), "created-by": userSimple.optional(), currency: currency, description: z.string(), id: z.number().int().optional(), name: z.string(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "warehouse-locations": z.array(warehouseLocation).optional(), "warehouse-type": warehouseType}); export const inventoryOrganization = z.object({"created-at": z.string().optional(), currency: currency, "fulfillment-type": z.enum(["manual", "automatic"]), id: z.number().int().optional(), "updated-at": z.string().optional(), warehouses: z.array(warehouse).optional()}); export const invoiceEmail = z.object({"created-at": z.string().optional(), "created-by": userSimple.optional(), email: z.string(), id: z.number().int().optional(), "send-notification": z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const onlineStore = z.object({"created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), login: z.string().optional(), password: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), url: z.string()}); export const paymentTerm = z.object({active: z.boolean().optional(), "active?": z.string().optional(), code: z.string(), "content-groups": z.array(businessGroup).optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), "days-for-discount-payment": z.number().int(), "days-for-net-payment": z.number().int(), description: z.string().optional(), "discount-cutoff-day": z.number().int().optional(), "discount-due-day": z.number().int(), "discount-due-month": z.number().int(), "discount-rate": z.number().optional(), id: z.number().int().optional(), "net-cutoff-day": z.number().int().optional(), "net-due-day": z.number().int(), "net-due-month": z.number().int(), type: z.enum(["DaysAfterNetPaymentTerm", "SpecificDayPaymentTerm", "BaseEomToDaysPaymentTerm", "DaysToBaseEomPaymentTerm"]), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const supplierAddress = z.object({active: z.boolean().optional(), attention: z.string().optional(), "business-group-name": z.string().optional(), city: z.string(), "content-groups": z.array(businessGroup).optional(), country: country, "created-at": z.string().optional(), "created-by": userSimple.optional(), id: z.number().int().optional(), "local-tax-number": z.string(), "location-code": z.string().optional(), name: z.string().optional(), "postal-code": z.string(), purposes: z.array(purpose).optional(), state: z.string().optional(), "state-iso-code": z.string().optional(), street1: z.string(), street2: z.string().optional(), street3: z.string().optional(), street4: z.string().optional(), "tax-registrations": z.array(address).optional(), type: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "vat-country": country.optional(), "vat-number": z.string().optional()}); export const remitToAddress = z.object({active: z.boolean().optional(), city: z.string(), country: country, "created-at": z.string().optional(), "created-by": userSimple.optional(), "external-src-name": z.string().optional(), "external-src-ref": z.string().optional(), id: z.number().int().optional(), "local-tax-number": z.string(), name: z.string().optional(), "postal-code": z.string(), "remit-to-code": z.string(), state: z.string().optional(), "state-iso-code": z.string().optional(), street1: z.string(), street2: z.string().optional(), street3: z.string().optional(), street4: z.string().optional(), "tax-registrations": z.array(address).optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), "vat-country": country.optional(), "vat-number": z.string().optional()}); export const shippingTerm = z.object({active: z.boolean().optional(), "active?": z.string().optional(), code: z.string(), "content-groups": z.array(businessGroup).optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), id: z.number().int().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const tag = z.object({active: z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), id: z.number().int().optional(), name: z.string(), "system-tag": z.boolean().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const tagging = z.object({active: z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), id: z.number().int().optional(), tag: tag.optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const taxRateType = z.object({active: z.boolean().optional(), country: country.optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), "effective-date": z.string().optional(), "expiration-date": z.string().optional(), id: z.number().int().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const taxRate = z.object({active: z.boolean().optional(), country: country.optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), "customer-accounting": z.boolean().optional(), description: z.string().optional(), "effective-date": z.string().optional(), exempt: z.boolean().optional(), "expiration-date": z.string().optional(), id: z.number().int().optional(), "out-of-scope": z.boolean().optional(), percentage: z.number(), "reverse-charge": z.boolean().optional(), "tax-description": z.string().optional(), "tax-rate-type": taxRateType.optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const taxCode = z.object({active: z.boolean().optional(), code: z.string(), country: country, "created-at": z.string().optional(), "created-by": userSimple.optional(), description: z.string().optional(), "effective-date": z.string().optional(), id: z.number().int().optional(), percentage: z.number(), "tax-rate": taxRate.optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional()}); export const supplier: z.ZodType = z.object({"account-number": z.string().optional(), "account-types": z.array(accountType).optional(), "allow-change-requests": z.boolean().optional(), "allow-cn-no-backing-doc-from-connect": z.boolean().optional(), "allow-csp-access-without-two-factor": z.boolean().optional(), "allow-cxml-invoicing": z.boolean().optional(), "allow-inv-choose-billing-account": z.boolean().optional(), "allow-inv-from-connect": z.boolean().optional(), "allow-inv-no-backing-doc-from-connect": z.boolean().optional(), "allow-inv-unbacked-lines-from-connect": z.boolean().optional(), "allow-order-confirmation-item-substitutions": z.boolean().optional(), "business-entity-id": z.number().int().optional(), "buyer-hold": z.boolean().optional(), commodity: commodity.optional(), "confirm-by-hrs": z.number().optional(), contacts: z.array(contact).optional(), "content-groups": z.array(businessGroup).optional(), "corporate-url": z.string().optional(), "coupa-connect-secret": z.string().optional(), "coupa-pay-financing-only": z.boolean().optional(), "created-at": z.string().optional(), "created-by": userSimple.optional(), "customer-support-contacts": z.array(customerSupportContact).optional(), "cxml-domain": z.string().optional(), "cxml-http-password": z.string().optional(), "cxml-http-username": z.string().optional(), "cxml-identity": z.string().optional(), "cxml-invoice-buyer-domain": z.string().optional(), "cxml-invoice-buyer-identity": z.string().optional(), "cxml-invoice-secret": z.string().optional(), "cxml-invoice-supplier-domain": z.string().optional(), "cxml-invoice-supplier-identity": z.string().optional(), "cxml-protocol": z.string().optional(), "cxml-secret": z.string().optional(), "cxml-ssl-version": z.string().optional(), "cxml-supplier-domain": z.string().optional(), "cxml-supplier-identity": z.string().optional(), "cxml-url": z.string().optional(), "dd-settings": z.string().optional(), "default-locale": z.string().optional(), "disable-cert-verify": z.boolean().optional(), "display-name": z.string().optional(), diversities: z.array(diversityAssociation).optional(), "diversity-categories": z.array(z.lazy(() => supplier)).optional(), "do-not-accelerate": z.boolean().optional(), duns: z.string().optional(), enterprise: enterprise, "hold-invoices-for-ap-review": z.boolean().optional(), id: z.number().int().optional(), "integration-contacts": integrationContact.optional(), "inventory-organization": inventoryOrganization.optional(), "invoice-emails": z.array(invoiceEmail).optional(), "invoice-matching-level": z.enum(["2-way", "3-way", "3-way-direct", "none"]).optional(), name: z.string(), number: z.string().optional(), "on-hold": z.boolean().optional(), "one-time-supplier": z.boolean().optional(), "online-store": onlineStore, "order-confirmation-level": z.number().int().optional(), parent: z.lazy(() => supplier.optional()), "payment-method": z.string(), "payment-term": paymentTerm.optional(), "payment-term-id": z.number().int().optional(), "payment-terms": z.array(paymentTerm).optional(), "po-change-method": z.enum(["cxml", "xml", "email", "prompt", "mark_as_sent", "buy_online"]).optional(), "po-email": z.string().optional(), "po-method": z.enum(["cxml", "xml", "email", "prompt", "mark_as_sent", "buy_online"]).optional(), "preferred-commodities": z.array(commodity).optional(), "primary-address": supplierAddress, "primary-contact": contact, "remit-to-addresses": z.array(remitToAddress).optional(), "remit-to-requirement": z.number().int().optional(), "restricted-account-types": z.array(accountType).optional(), "savings-pct": z.number().optional(), "scf-configs": z.string().optional(), "scope-three-emissions": z.boolean().optional(), "send-invoices-to-approvals": z.boolean().optional(), "shipping-term": shippingTerm.optional(), status: z.string().optional(), "storefront-url": z.string().optional(), "supplier-account-types": z.array(z.lazy(() => supplier)).optional(), "supplier-addresses": z.array(supplierAddress).optional(), "supplier-community-enablement": z.number().int().optional(), "supplier-sites": z.array(z.lazy(() => supplier)).optional(), taggings: z.array(tagging).optional(), "tax-code": taxCode.optional(), "tax-id": z.string().optional(), type: z.string().optional(), "updated-at": z.string().optional(), "updated-by": userSimple.optional(), website: z.string().optional(), "whitelist-dd": z.boolean().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Show supplier * * GET /suppliers/{id} * * Also accepts auth: OAuth2ClientCredential */ export const getApiSuppliersId = async (args: GetApiSuppliersIdArgs, options?: GetApiSuppliersIdOptions) => { const {baseUrl = "https://r38.coupadev.com/api", fetch: fetchFn = fetch, OAuth2AccessCode} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.limit != null) query.append("limit", String(args.limit)) if (args.offset != null) query.append("offset", String(args.offset)) if (args.order_by != null) query.append("order_by", String(args.order_by)) if (args.dir != null) query.append("dir", String(args.dir)) if (args.return_object != null) query.append("return_object", String(args.return_object)) if (args.filter != null) query.append("filter", String(args.filter)) if (OAuth2AccessCode !== undefined) headers.set('authorization', `Bearer ${OAuth2AccessCode}`) const url = `${baseUrl.replace(/\/+$/, '')}/suppliers/${encodeURIComponent(String(args.id))}${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(supplier, await res.json()) };