View as Markdown
Finmei icon

Finmei ACTION

Create Invoice

Generates a new invoice within Finmei. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Finmei account once, then configure and run Create Invoice from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "finmei-create-invoice",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    finmei: { authProvisionId: "apn_xxxxxxx" },
    type: "Type",
    date: "Date",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Invoice inputs
Property Type Description
type Type string
The type of invoice to create
Required
date Date string
Date showed in the invoice. Format: YYYY-MM-DD
Required
series Series string
Invoice series in string format
Required
currency Currency string
Uppercase three letter currency code, e.g. USD
Required
buyer Buyer object
The buyer info, as an object. See the documentation for the properties. Example: { "type": "company", "company_name": "My Company" }
Required
products Product(s) string[]
One or more products as JSON-stringified objects. See the documentation for the properties. Example: { "name": "My Product", "units": "pcs", "quantity": 2, "price": 10 }
Required
useDefaultSellerInfo Use Default Seller Info boolean
If true, you do not need to provide seller info. Your business info and latest invoice information will be used.
Optional
additionalOptions Additional Options object
Additional parameters to send in the request. See the documentation for available parameters. Values will be parsed as JSON where applicable.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
finmei-create-invoice
Version
0.0.2
App
Finmei
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes