# Get your SFS Vendor Portal payments through an API

> Read the payments New York State agencies made to you, where each eInvoice stands and your purchase orders from the SFS Vendor Portal with one API call each. Or have a workflow hand each morning's new payments to your accounting system.

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

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

## What you can build on the Vendor Portal

### Get payments

Reads the payments New York State agencies have made to your organization in the Vendor Portal.

- Takes: Paid since (optional), agency (optional)
- Returns: Payment ID, payment date, agency, payment method, amount

### Check eInvoice status

Reads your invoices in the Vendor Portal and the step of invoice processing each one has reached.

- Takes: Invoice number (optional), invoice date from (optional)
- Returns: Invoice number, invoice date, agency, PO number, amount, status, payment date

### Get purchase orders

Reads the purchase orders New York State agencies have issued to your organization in the Vendor Portal.

- Takes: Issued since (optional), agency (optional)
- Returns: PO number, PO date, agency, status, lines, amount

### Submit a self-service invoice

Creates a Self-service Invoice (SSI) in the Vendor Portal, attaches the supporting documents and submits it.

- Takes: PO number, invoice number, invoice date, lines and amounts, supporting documents
- Returns: Invoice number, PO number, amount, status

## Automate the Vendor 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 State payments, posted to your accounting system

Starts: Every weekday at 7:00 (America/New_York)

1. Get the payments made to your organization since yesterday.
2. Keep the payments that were not there on the last run, and stop when there are none.
3. Post each payment with its date, agency and amount to your accounting system's webhook.

### Weekly eInvoice status report

Starts: Every Monday at 8:00 (America/New_York)

1. Check the status of every invoice dated in the last 90 days.
2. Keep the invoices not yet paid and those whose status changed since the last run.
3. Email you the list, grouped by agency.

### New purchase orders to your order system

Starts: Every weekday at 9:00 (America/New_York)

1. Get the purchase orders issued to your organization in the last 7 days.
2. Keep the POs that were not there on the last run.
3. Post each PO with its lines and amount to your order 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 payments” 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": "esupplier.sfs.ny.gov/get_payments",
    "input": {
      "paid_since": "2026-11-01"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "payments": [
      {
        "payment_id": "0004821937",
        "payment_date": "2026-11-06",
        "agency": "Northwind Agency",
        "payment_method": "ACH",
        "amount": 12480
      },
      {
        "payment_id": "0004833015",
        "payment_date": "2026-11-10",
        "agency": "Globex Agency",
        "payment_method": "ACH",
        "amount": 3275.5
      }
    ],
    "count": 2
  }
}
```

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.

## The Vendor Portal’s own options

SFS describes no API for vendors. You can enter eInvoices yourself in the Vendor Portal as Self-service Invoices, or, for a high volume of invoices, set up XML Data Exchange or EDI with the SFS Help Desk. Payments, purchase orders, invoices and grant work are reviewed in the portal.

| Option | What it covers | What it takes |
| --- | --- | --- |
| XML Data Exchange or EDI | Sends invoice data from your own system to SFS in XML or EDI format. | Recommended for more than about 100 invoices a year. Set up with guidance from the SFS Help Desk. |
| Self-service Invoice (SSI) | eInvoices entered one at a time in the Vendor Portal, with supporting documents that agency staff can view. | A Vendor Portal account. Recommended for fewer than about 100 invoices a year. |
| The Vendor Portal by hand | Reviewing payments, purchase orders and invoices, vendor information, prequalification, grant opportunities, contracts, progress reports and claims. | A Vendor Portal User ID and password for your organization. |

Read on November 12, 2026: [eInvoicing Options Available for Vendors](https://upk.sfs.ny.gov/UPK/VEN101/FILES/eInvoicing_Options_for_Vendors.pdf), [SFS for vendors](https://www.sfs.ny.gov/index.php/vendors).

## Signing in to the Vendor Portal

The Vendor Portal signs you in with a User ID and password. After several wrong passwords, or a long time without signing in, the account may be locked, and your organization's Delegated Admin resets the password and releases the account. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Your Delegated Admin manages accounts**: A locked vendor user, or a forgotten password, goes to the Delegated Admin of your organization, who can reset it. If you do not know who that is, ask your organization's Primary Contact.
- **Volume decides the invoicing route**: SFS recommends Self-service Invoices for fewer than about 100 invoices a year, and XML Data Exchange or EDI above that, set up through the SFS Help Desk.
- **eInvoices and 15 Day Prompt Payment**: Qualified small businesses that submit eInvoices may be eligible for 15 Day Prompt Payment. eInvoicing supports the Office of the State Comptroller's Proper Invoice Standards.
- **Grants live in the same portal**: Grant opportunities, prequalification, contract approval, progress reports and claims are all handled in the Vendor Portal. Nonprofits must be prequalified to apply for grants.

## More in Government: US state and local procurement

- [PASSPort](https://fous.com/automate/passport.md)
- [AASHTOWare Project Civil Rights & Labor](https://fous.com/automate/aashtoware-project-civil-rights-and-labor.md)
- [BidNet Direct](https://fous.com/automate/bidnet-direct.md)
- [Bonfire](https://fous.com/automate/bonfire.md)
- [OpenGov Procurement](https://fous.com/automate/opengov-procurement.md)
- [PlanetBids](https://fous.com/automate/planetbids.md)
- [Cal eProcure](https://fous.com/automate/cal-eprocure.md)
- [COMMBUYS](https://fous.com/automate/commbuys.md)
- [eVA](https://fous.com/automate/eva.md)
- [MyFloridaMarketPlace Vendor Information Portal](https://fous.com/automate/myfloridamarketplace-vendor-information-portal.md)
- [NC eProcurement](https://fous.com/automate/nc-eprocurement.md)

Other industries: [Minnesota e-Services](/automate/minnesota-e-services), [NCSUITS](/automate/ncsuits), [VWR (Avantor)](/automate/vwr-avantor), [Bullhorn](/automate/bullhorn), [McKesson Connect](/automate/mckesson-connect), [NIPR](/automate/nipr).

## Frequently asked questions

### Does the SFS Vendor Portal have an API?

No public API is described for vendors. SFS offers eInvoicing in two ways: Self-service Invoices entered in the Vendor Portal, or XML Data Exchange or EDI from your own system for a high volume of invoices, set up through the SFS Help Desk. Payments and purchase orders are reviewed in the portal.

### How do I check whether New York State has paid my invoice?

Sign in to the Vendor Portal and review your payments and invoices: SFS says vendors can track their invoices at every step of invoice processing. With Fous, a workflow can read new payments each morning and post them to your own system.

### Can I send many invoices to SFS at once?

Yes, through XML Data Exchange or EDI, which SFS recommends for vendors with more than about 100 invoices a year. Contact the SFS Help Desk for guidance on setting it up. Below that volume, SFS recommends Self-service Invoices in the portal.

### What do I do when my Vendor Portal account is locked?

Ask the Delegated Admin associated with your organization, who can reset your password and release your locked account. If you do not know who that is, contact your organization's Primary Contact. For other problems, the SFS Help Desk takes vendor calls at 855-233-8363 toll-free.

### Is Fous affiliated with New York State Statewide Financial System?

No. Fous is an independent product. You use it with your own SFS Vendor 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 SFS Vendor Portal (New York State Statewide Financial System). 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.
