Create Expense

POST /api/accrued-expenses

Creates a new manual expense entry for a specific profile and period. This endpoint is used for expenses that are not imported from XML files.

Authentication

This endpoint requires authentication. Include your access token in the request cookies.

Request Body

string

required

ID of the profile (RFC emisor) to associate this expense with

string

required

ID of the accounting period for this expense

string

required

Description or concept of the expense

number

required

Subtotal amount before taxes

number

IVA (VAT) amount. If not provided, defaults to 0

string

required

Date of the expense in ISO 8601 format (e.g., “2024-03-15”)

string

required

Type of expense. Must be manual

string

Category for organizing the expense

Response

string

required

Success message

Expense

required

The created expense object

Show Expense Object

string

required

Unique identifier for the expense

string

required

Profile ID associated with this expense

string

required

Origin type. Will be MANUAL

string

required

Date of the expense (ISO 8601 format)

number

required

Month extracted from fecha (1-12)

number

required

Year extracted from fecha

number

required

Total amount (subtotal + iva_amount)

number

required

Subtotal before taxes

number

required

IVA percentage calculated from amounts

number

IVA amount

string

required

Description/concept of the expense

string

Category of the expense

string

required

Creation timestamp (ISO 8601)

string

required

Last update timestamp (ISO 8601)

Example Request

curl -X POST "https://api.contafy.com/api/accrued-expenses" \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=your_access_token" \
  -d '{
    "profile_id": "profile-123",
    "period_id": "period-456",
    "concept": "Compra de papelería",
    "subtotal": 1000,
    "iva_amount": 160,
    "fecha": "2024-03-15",
    "type": "manual",
    "categoria": "Gastos de oficina"
  }'

Example Response

{
  "message": "Expense created successfully",
  "data": {
    "id": "expense-789",
    "profile_id": "profile-123",
    "tipo_origen": "MANUAL",
    "fecha": "2024-03-15T00:00:00Z",
    "mes": 3,
    "año": 2024,
    "total": 1160,
    "subtotal": 1000,
    "iva": 16,
    "iva_amount": 160,
    "concepto": "Compra de papelería",
    "categoria": "Gastos de oficina",
    "created_at": "2024-03-15T10:30:00Z",
    "updated_at": "2024-03-15T10:30:00Z"
  }
}

Error Responses

error

Authentication required or token expired

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

error

Invalid request body or missing required fields

{
  "error": "Bad Request",
  "message": "Missing required field: concept"
}

error

User does not have permission to create expenses for this profile

{
  "error": "Forbidden",
  "message": "You do not have permission to access this profile"
}

error

Server error occurred

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

Authentication

Profiles

Invoices

Expenses

Subscription

SAT Search

POST /api/accrued-expenses

Authentication

Request Body

Response

Example Request

Example Response

Error Responses

​POST /api/accrued-expenses

​Authentication

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

POST /api/accrued-expenses

Authentication

Request Body

Response

Example Request

Example Response

Error Responses