---
title: "Crear una nueva factura"
method: POST
path: "/invoice"
tags: ["Facturas"]
---

# Crear una nueva factura

`POST /invoice`

Crear una nueva factura con la posibilidad de crear un contacto nuevo o usar uno existente

## Request body

- object
  - `contactId` number
  - `description` string
  - `date` string, required
  - `totalAmount` number — Monto total de la factura, si se envia items el monto va a ser ignorado
  - `expirationDate` string, required
  - `externalReference` string
  - `newContact` object
    - `externalReference` string
    - `existingContactId` number — Id de un contacto ya existente. Si viene seteado, no se crea un contacto nuevo: solo se asocia el pagador (payerContact) al contacto existente.
    - `name` string, required
    - `lastName` string, required
    - `documentType` 'DNI' | 'CUIT' | 'CUIL' | 'CDI' | 'LE' | 'LC' | 'CI Extranjera' | 'Pasaporte' | 'CI Policía Federal' | 'Certificado de Migración' | 'RUT' | 'Otro'
    - `documentNumber` string
    - `email` string, email
    - `phoneNumber` string
    - `address` string
    - `country` string
    - `metadata` object — Informacion adicional que luego se puede consumir y llegara en los webhooks
    - `payerContact` object
      - `name` string, required
      - `lastName` string, required
      - `documentType` 'DNI' | 'CUIT' | 'CUIL' | 'CDI' | 'LE' | 'LC' | 'CI Extranjera' | 'Pasaporte' | 'CI Policía Federal' | 'Certificado de Migración' | 'RUT' | 'Otro', required
      - `documentNumber` string, required
      - `email` string, email, required
      - `phoneNumber` string, required
      - `address` string
      - `country` string
    - `tagGroup` object
      - `name` string, required
    - `tags` object[]
      - `name` string, required
    - `sendPortalInvite` boolean
  - `sendEmail` boolean — Envía email a los pagadores del contacto con acceso al portal para que page la factura.
  - `items` object[], nullable — 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.
    - `itemId` number, required
    - `quantity` number — Cantidad de items a asociar a la factura
  - `itemGroups` object[], nullable
    - `itemGroupId` number, required
    - `selectedItems` object[], nullable
      - `itemId` number, required
      - `quantity` number — Cantidad de items a asociar a la factura
  - `serviceCost` object
    - `cost` number, required
    - `percentage` number, required
  - `customItems` object[]
    - `name` string, required
    - `description` string
    - `amount` number, required
    - `type` 'credit' | 'debit', required
    - `quantity` number, required
    - `details` union
      - object
        - `source` 'item', required
        - `discountItemId` number, required
        - `amountType` string, required
        - `configuredAmount` number, required
        - `condition` string, required
        - `conditionItems` object[], required
          - `id` number, required
        - `baseAmount` number, nullable, required
        - `appliedAmount` number, required
        - `maxDiscountAmount` number, nullable, required
        - `cartItems` object[], required
          - `itemId` number, required
          - `totalAmount` number, required
        - `breakdown` object[], required
          - `itemId` number, required
          - `discountAmount` number, required
      - object
        - `source` 'manual', required
        - `condition` string
        - `conditionItems` object[]
          - `id` number, required
        - `appliedAmount` number
        - `cartItems` object[]
          - `itemId` number, required
          - `totalAmount` number, required
        - `breakdown` object[]
          - `itemId` number, required
          - `discountAmount` number, required

## Response `201`

Factura creada con éxito

- object
  - `invoiceId` number, required
  - `contactId` number, required

## Other responses

- `400` — Bad request, invalid input data
- `404` — Resources not found

---

[API](https://skmtc.dev/fint/apis/fint-api.md) · [All operations](https://skmtc.dev/fint/apis/fint-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fint/fint-api/revisions/5c95bce0a002/schema)