SiigoAPI
Siigo API

Crear Recibo de caja - Avanzado

Crear un nuevo Recibo de caja avanzado.

Este tipo de recibo de caja tiene la característica de poder asociar múltiples registros contables en donde puede llevarse a cabo la adición de cuentas de bancos, vencimientos e impuestos.

Json de ejemplo:

{
	"document": {
		"id": 24445
	},
	"date": "2023-12-15",
	"type": "Detailed",
	"customer": {
		"identification": "8694251",
		"branch_office": 0
	},
	"items": [
		{
			"account": {
				"code": "11100501",
				"movement": "Debit"
			},
			"description": "FV-2 Base",
			"value": 50
		},
		{
			"account": {
				"code": "13050501",
				"movement": "Credit"
			},
			"due": {
				"prefix": "FV-1",
				"consecutive": 684,
				"quote": 1,
				"date": "2020-02-15"
			},
			"description": "FV-2 Base",
			"value": 50
		},
		{
			"account": {
				"code": "24081001",
				"movement": "Debit"
			},
			"tax": {
				"id": 13156
			},
			"description": "FV-2 Base",
			"value": 19
		},
		{
			"account": {
				"code": "11100501",
				"movement": "Credit"
			},
			"description": "FV-2 Base",
			"value": 19
		}
	],
	"observations": "observación de prueba"
}
POST
/v1/vouchers

Authorization

Authorization<token>

In: header

Partner-Id<token>

In: header

Request Body

application/jsonOptional

Represents the request with the voucher information.

document
Required
object
numberinteger

Representa el número secuencial del documento, este número es requerido dependiendo del tipo de documento.

Format: "int64"
namestring

Contiene información sobre el tipo de documento, el ID del tipo de documento y el número secuencial del documento. Por ejemplo, 'RC-2-22' indica que su tipo de documento es un 'comprobante', su ID de tipo de documento es '2' y su número secuencial es '22'.

date
Required
string

Representa la fecha del documento. Este formato debe ser 'aaaa-MM-dd'. Por ejemplo, '2021-10-31' para indicar la fecha '31 de octubre de 2021'.

type
Required
string

Representa el tipo de comprobante, este tipo será 'PagoDeDeuda', 'PagoAnticipado' o 'Detallado'.

customerobject
cost_centerinteger

Representa el ID del centro de costos, el valor de este campo debe ser un número entero que representa el ID único del centro de costos.

Format: "int64"
currencyobject
itemsarray<object>

Contiene una lista con los ítems asociados al comprobante.

payments
Required
object
observationsstring

Representa comentarios adicionales en el documento.

curl -X POST "https://api.siigo.com/v1/vouchers" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "document": {
      "id": 22
    },
    "number": 25,
    "name": "RC-2-22",
    "date": "2021-10-31",
    "type": "DebtPayment",
    "customer": {
      "identification": "13832081",
      "branch_office": 0
    },
    "cost_center": 235,
    "currency": {
      "code": "USD",
      "exchange_rate": 3825.03
    },
    "items": [
      {
        "account": {
          "code": "11050501",
          "movement": "Credit"
        },
        "description": "This is a description",
        "due": {
          "prefix": "FV-1",
          "consecutive": 68,
          "quote": 1,
          "date": "2021-04-22"
        },
        "tax": {
          "id": 13156
        },
        "value": 119000
      }
    ],
    "payment": {
      "id": 5636,
      "value": 1273.03
    },
    "observations": "This is an observation"
  }'

Success

{
  "id": "63f918c2-ca65-4edc-a7db-66bcdd5159fb",
  "document": {
    "id": 22
  },
  "number": 25,
  "name": "RC-2-22",
  "date": "2021-10-31",
  "type": "DebtPayment",
  "cost_center": 235,
  "customer": {
    "id": "302580df-838b-4531-b8bf-dd3c98b34059",
    "identification": "13832081",
    "branch_office": 0
  },
  "currency": {
    "code": "USD",
    "exchange_rate": 3825.03
  },
  "items": [
    {
      "account": {
        "code": "11050501",
        "movement": "Credit"
      },
      "due": {
        "prefix": "FV-1",
        "consecutive": 68,
        "quote": 1,
        "date": "2021-04-22"
      },
      "tax": {
        "id": 13156,
        "name": "VAT 19%",
        "type": "IVA",
        "percentage": 19,
        "value": 5,
        "base_value": 2000
      },
      "description": "This is a description",
      "value": 119000
    }
  ],
  "payment": {
    "id": 5636,
    "name": "Credit",
    "value": 1273.03,
    "due_date": "2021-03-19"
  },
  "observations": "This is an observation",
  "metadata": {
    "created": "string",
    "last_updated": "string",
    "stock_updated": "string"
  }
}