Skip to main content
POST
/
invoice
Crear una nueva factura
curl --request POST \
  --url https://api.fint.app/api/v1/invoice \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "date": "<string>",
  "expirationDate": "<string>",
  "contactId": 123,
  "description": "<string>",
  "totalAmount": 123,
  "externalReference": "<string>",
  "sendEmail": true,
  "items": [
    {
      "itemId": 123,
      "quantity": 1
    }
  ],
  "itemGroups": [
    {
      "itemGroupId": 123,
      "selectedItems": [
        {
          "itemId": 123,
          "quantity": 1
        }
      ]
    }
  ],
  "customItems": [
    {
      "name": "<string>",
      "amount": 123,
      "type": "credit",
      "quantity": 123,
      "description": "<string>",
      "details": {
        "source": "item",
        "discountItemId": 123,
        "amountType": "<string>",
        "configuredAmount": 123,
        "condition": "<string>",
        "conditionItems": [
          {
            "id": 123
          }
        ],
        "baseAmount": 123,
        "appliedAmount": 123,
        "maxDiscountAmount": 123,
        "cartItems": [
          {
            "itemId": 123,
            "totalAmount": 123
          }
        ],
        "breakdown": [
          {
            "itemId": 123,
            "discountAmount": 123
          }
        ]
      }
    }
  ]
}
'
{
  "invoiceId": 123,
  "contactId": 123
}

Authorizations

x-api-key
string
header
required

Body

application/json
date
string
required
expirationDate
string
required
contactId
number
description
string
totalAmount
number

Monto total de la factura, si se envia items el monto va a ser ignorado

externalReference
string
newContact
object
sendEmail
boolean
default:true

Envía email a los pagadores del contacto con acceso al portal para que page la factura.

items
object[] | null

Items de tipo subscription (one_time) o settlement (condition: none). Todos los items deben tener el mismo useCase. Si items esta presente el totalAmount va a ser autocalculado.

itemGroups
object[] | null
serviceCost
object
customItems
object[]

Response

Factura creada con éxito

invoiceId
number
required
contactId
number
required