사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/payabli/integration-skills --skill payabli-bills시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Payabli bills (AP automation)
Capture vendor bills and pay them.
Load fundamentals first
If payabli-fundamentals is not already loaded, load it now, then continue.
On load
If payabli-integration.md exists at the repo root, read it; honor its ## SDK value.
Capture a bill
Create a bill with POST /Bill/single/{entry} — identify the vendor with a nested vendor object (vendor: { vendorNumber }) — a top-level vendorNumber is rejected. Plus amount, due date, and an optional bill image. A bill needs only a top-level netAmount; unlike invoices, line items aren't required — but if you do send billItems, their itemTotalAmount must sum to netAmount exactly (the API adds nothing on top), or the create fails with 400 ("Sum of BillItems does not match Bill TotalAmount"). Bulk-import with POST /Import/billsForm/{entry}. https://docs.payabli.com/guides/pay-out-developer-bills-manage.md
Set status: 1 (Active) on create so the bill is immediately payout-eligible. -99 is Cancelled — don't use it.
Bill OCR is a standalone capture path — Payabli's OCR engine extracts bill data (line items, amounts, vendor details) from a PDF or image. It is its own feature, not part of vendor enrichment. Extract via POST /Import/ocrDocumentForm/{typeResult} (multipart) or /Import/ocrDocumentJson/{typeResult} (base64), with typeResult set to bill. https://docs.payabli.com/guides/pay-ops-developer-ocr-use.md
When you create a bill from an OCR result, build the `POST /Bill/single` payload explicitly from the fields you actually need — billNumber, netAmount, dueDate (plus any other dates), the nested vendor: { vendorNumber }, and status: 1. Don't spread the raw OCR envelope (responseData.resultData, or the full response with attachments / totalAmount / discount / billItems) into the create call: the shapes don't line up, and you'll get 400 "field BillNumber empty" or 400 "The sum of netAmount and discount is more than the total from the original bill". Map the extracted values onto a clean bill instead, keeping the netAmount == sum(billItems) rule above.
List bills
List bills with GET /Query/bills/{entry}. Filter by vendorNumber(eq) or vendorId(eq) — `idVendor(eq)` is silently ignored and returns every bill, so never use it to scope to a vendor. Query basics (filter syntax, pagination) → payabli-reporting.
Pay the bill
Bills are paid through Pay Out — see payabli-send-payments. One payout can pay multiple bills for the same vendor. (A raw payout can skip bill creation with doNotCreateBills: true.)
Bills vs. invoices
A bill is money out (a vendor's invoice that you pay); an invoice is money in (you billing a customer — payabli-invoices). https://docs.payabli.com/guides/platform-bills-vs-invoices.md
Boundaries
- Payout mechanics, vendors, and vendor enrichment →
payabli-send-payments - Customer-facing invoices →
payabli-invoices