# Turn Basware Portal into an API

> Read your sent invoices with their delivery status, the purchase orders in your Inbox and each document's History from Basware Portal with one API call each. Or have a workflow read the Sent tab every weekday and post the invoices stuck in Delivery Delayed.

Page: https://fous.com/automate/basware-portal
Updated: 2026-11-12

Works with your own Basware Portal account. Fous is an independent product.

## What you can build on Basware Portal

### Get sent invoices and their status

Reads the Sent tab of the Documents page, filtered to invoices, with each invoice's status and last update.

- Takes: Recipient (optional), status (optional), invoice date from (optional)
- Returns: Invoice number, recipient, invoice date, due date, total, currency, status, last updated

### Get received purchase orders

Reads the purchase orders on the Inbox tab of the Documents page and opens each one for its Line Data.

- Takes: Buyer (optional), status (optional), received since (optional)
- Returns: PO number, buyer, status, last updated, lines with product code, name, quantity, unit, unit price, net total

### Get a document's history

Opens one invoice or purchase order and reads its History tab: when it was sent, accepted and paid.

- Takes: Document number
- Returns: Document number, type, status, history events with date and description

### Accept a purchase order

Opens a purchase order from the Documents page, clicks Accept, adds Comments to buyer and confirms, so the order moves to Accepted.

- Takes: PO number, comments to buyer (optional)
- Returns: PO number, buyer, status

## Automate Basware Portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New purchase orders in the Inbox, every morning

Starts: Every weekday at 7:00

1. Get the received purchase orders from the Inbox tab.
2. Keep the purchase orders that were not there on the last run.
3. Email you the list with PO number, buyer and line items.

### Invoices stuck in Delivery Delayed or rejected

Starts: Every weekday at 9:00

1. Get the sent invoices with status Delivery Delayed or Rejected during Delivery.
2. Keep the invoices whose status changed since the last run.
3. Post invoice number, recipient, total and status to your Slack or ERP webhook.

### Weekly invoice status report for accounting

Starts: Every Monday at 8:00

1. Get the invoices sent in the last 30 days with their status.
2. For each invoice, read its History for accepted and paid dates.
3. Post the list to your accounting system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get sent invoices and their status” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "portal.basware.com/get_sent_invoices",
    "input": {
      "status": "Delivery Delayed",
      "invoice_date_from": "2026-10-01"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "invoices": [
      {
        "invoice_number": "INV-20417",
        "recipient": "Acme Manufacturing",
        "invoice_date": "2026-11-06",
        "due_date": "2026-12-06",
        "total": 4820.5,
        "currency": "EUR",
        "status": "Delivery Delayed",
        "last_updated": "2026-11-10T08:14:00Z"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Basware Portal’s own options

Basware Network has an API for sending and receiving e-invoices: you test it in a free sandbox account from Basware Support, and production use needs a subscription to one of Basware's services. For suppliers, Invoice Key-In is a free service the customer provides, and the optional PO Flip turns purchase orders into invoices.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Basware Network API | Sending e-invoices, converted into 70+ output formats, and receiving invoices in one common format. | A subscription to one of Basware's services. A free sandbox testing account comes from Basware Support. |
| Network partners | Sending and receiving e-invoices through your own e-invoicing operator instead of the portal. | An agreement with one of Basware's 220+ network partners. |
| Basware Portal by hand | Invoice Key-In and PO Flip: the Documents page with All, Inbox and Sent tabs, invoice entry, and accepting or converting purchase orders. | A Basware Portal account. Invoice Key-In is free when your customer provides it; PO Flip is an optional service. |

Read on November 12, 2026: [Basware Network API: get started](https://developer.basware.com/en/api/network/get-started), [Basware for suppliers](https://www.basware.com/en/for-suppliers), [Invoice Key-In and PO Flip user guide](https://s3-eu-west-1.amazonaws.com/user-guidance/documentation/network-services/user-guides/en-us/pdf/Basware.Invoice.Key-In.and.PO.Flip.User.Guide_EN-US.pdf).

## Signing in to Basware Portal

Basware's user guide has you log in at portal.basware.com with your Username and Password, and log out from the menu under your username. With Fous you sign in once through that same sign-in with your own account: the login is sealed with AES-256, code and AI agents never see it, and an expired session is signed back in.

## Worth knowing

- **The Documents page shows 30 days by default**: Searches show documents sent and received in the last 30 days until you close the Date Range pane, so a method that reads older invoices takes a date as an input.
- **Accept a purchase order before invoicing it**: Only a purchase order in Accepted status can be converted with Convert to Invoice, and that needs the optional Invoice Key-In and PO Flip service.
- **Delivery Delayed for more than 24 hours**: When a document stays in Delivery Delayed for more than 24 hours, Basware asks you to contact Basware Support. A daily check of your sent invoices shows you which ones.
- **Invoice data is not kept forever**: Basware Network does not store invoice data indefinitely. Basware's guide tells you to download a copy of the document image from the Files tab and keep it yourself.

## More in Procurement

- [Petronect](https://fous.com/automate/petronect.md)
- [BtoBプラットフォーム 請求書](https://fous.com/automate/infomart-btob-platform-invoice.md)
- [Tungsten Network](https://fous.com/automate/tungsten-network.md)
- [Taulia supplier portal](https://fous.com/automate/taulia-supplier-portal.md)
- [OpenInvoice](https://fous.com/automate/openinvoice.md)
- [Tipalti Supplier Hub](https://fous.com/automate/tipalti-supplier-hub.md)
- [Coupa Supplier Portal](https://fous.com/automate/coupa-supplier-portal.md)
- [JAGGAER Supplier Network](https://fous.com/automate/jaggaer-supplier-network.md)
- [SAP Business Network](https://fous.com/automate/sap-business-network.md)
- [Oracle Fusion Cloud Supplier Portal](https://fous.com/automate/oracle-fusion-cloud-supplier-portal.md)
- [Workday supplier portal](https://fous.com/automate/workday-supplier-portal.md)
- [Nalanda](https://fous.com/automate/nalanda.md)
- [Avetta](https://fous.com/automate/avetta.md)
- [ISNetworld](https://fous.com/automate/isnetworld.md)

Other industries: [Comarch ERP Optima](/automate/comarch-erp-optima), [微信公众平台](/automate/wechat-official-accounts-platform), [AutoZonePro](/automate/autozonepro), [GM GlobalConnect](/automate/gm-globalconnect), [Workday](/automate/workday), [LCPtracker](/automate/lcptracker).

## Frequently asked questions

### Does Basware Portal have an API?

Basware offers the Basware Network API, which sends and receives e-invoices. You test it in a free sandbox account from Basware Support, and production use needs a subscription to one of Basware's services. Suppliers on the free Invoice Key-In work in the portal by hand.

### What do the Basware invoice statuses mean?

They track delivery. Draft is not sent yet, Ready for Delivery and Delivery in Progress are on the way, Delivered to Recipient has arrived, and Received means the recipient opened it. Rejected during Delivery and Delivery Delayed need your attention.

### How do I turn a Basware purchase order into an invoice?

Accept it first, then use Convert to Invoice. Open the purchase order on the Documents page, click Accept and Confirm, then click Convert to Invoice. Basware Portal copies the order's data onto a draft invoice that you check and send. This needs the Invoice Key-In and PO Flip service.

### Where can I see whether my customer paid an invoice?

On the invoice's History tab. The business document page's History tab lists dates such as when the document was first sent, accepted by the recipient and paid.

### Is Fous affiliated with Basware?

No. Fous is an independent product. You use it with your own Basware Portal account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Basware Portal (Basware). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
