Crea una nueva factura de proveedor

post

https://api.admcloud.net/api/VendorBills

Valida y guarda una nueva factura de proveedor. Devuelve el identificador (GUID) del
documento creado.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

company

string

Nombre de la base de datos de la empresa.

Obligatoriedad: Opcional

Tipo de dato: String

role

string

Nombre del grupo de usuarios al que pertenece el usuario actual.

Obligatoriedad: Opcional

Tipo de dato: String

appid

uuid

Identificador de la integración que va a consumir el API.

Obligatoriedad: Opcional

Tipo de dato: GUID

token

string

Token de sesión generado con el método de Token.

Obligatoriedad: Opcional

Tipo de dato: String

Body Params

Documento de la factura de proveedor a crear (encabezado, líneas, archivos y campos personalizados).

Obligatoriedad: Requerido

Tipo de dato: SA_Transactions

Entidad universal de transacción del iERP.

uuid

Descripción: Identificador de la transacción.

Obligatoriedad: Condicional a que sea una actualización (PUT)

Tipo de dato: GUID

SubsidiaryID

uuid

Descripción: Identificador de la subsidiaria a la que pertenece la transacción.

Obligatoriedad: Condicional a que la empresa tenga subsidiarias habilitadas

Tipo de dato: GUID

DocID

string

length between 0 and 200

Descripción: Número o código de la transacción. Si se omite, el sistema lo genera según la numeración configurada.

Obligatoriedad: Opcional

Tipo de dato: String

DocType

string

required

length between 0 and 10

Descripción: Tipo de documento (código interno).

Obligatoriedad: Requerido

Tipo de dato: String

DocDate

date-time

required

Descripción: Fecha de la transacción.

Obligatoriedad: Requerido

Tipo de dato: DateTime (Formato: YYYY-MM-dd)

Reference

string

length between 0 and 200

Descripción: Referencia de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

RelationshipID

uuid

Descripción: Identificador del relacionado asociado a la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

ShipmentMethodID

uuid

Descripción: Identificador del método de envío de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

FiscalSequenceTypeID

string

length between 0 and 10

Descripción: Tipo de comprobante fiscal (NCF) de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

DepartmentID

uuid

Descripción: Identificador del departamento de la transacción. En documentos contables se utiliza como centro de beneficio del asiento.

Obligatoriedad: Opcional

Tipo de dato: GUID

LocationID

uuid

Descripción: Identificador de la ubicación de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

GroupID

uuid

Descripción: Identificador del grupo de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

PaymentTermID

uuid

Descripción: Términos de pago de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

DivisionID

uuid

Descripción: Identificador de la división de la transacción. En documentos contables se utiliza como centro de beneficio del asiento.

Obligatoriedad: Opcional

Tipo de dato: GUID

ItemClassID

uuid

Descripción: Identificador de la línea de negocio asociada a la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

Beneficiary

string

length between 0 and 200

Descripción: Beneficiario de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

Notes

string

Descripción: Observaciones de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

InternalNotes

string

Descripción: Notas internas de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

CurrencyID

string

length between 0 and 3

Descripción: Código ISO de la moneda de la transacción (3 caracteres, p. ej. DOP, USD).

Obligatoriedad: Opcional

Tipo de dato: String

ExchangeRate

double

Descripción: Tasa de cambio de la moneda de la transacción respecto a la moneda local.

Obligatoriedad: Opcional

Tipo de dato: Decimal

PaymentMethodID

uuid

Descripción: Identificador del modo de pago de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

SourceTransactionID

uuid

Descripción: Identificador de la transacción de origen de la que se derivó esta transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

NCF

string

length between 0 and 25

Descripción: Número de comprobante fiscal (NCF) de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

ExpirationDate

date-time

Descripción: Fecha de expiración de la secuencia fiscal (NCF) de la transacción.

Obligatoriedad: Opcional

Tipo de dato: DateTime (Formato: YYYY-MM-dd)

FiscalAuthorizationNumber

string

Descripción: Número de autorización fiscal de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

FiscalSerialNumber

string

Descripción: Número de serie fiscal de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

ExpenseTypeID

uuid

Descripción: Tipo de gasto de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

TaxRetentionTypeID

string

length between 0 and 10

Descripción: Tipo de retención de la transacción.

Obligatoriedad: Opcional

Tipo de dato: String

FiscalID

string

length between 0 and 200

Descripción: Identificador fiscal del relacionado asignado por la entidad recaudadora de impuestos.

Obligatoriedad: Opcional

Tipo de dato: String

TransTypeID

uuid

Descripción: Identificador del tipo de transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

InventoryImportID

uuid

Descripción: Identificador de la liquidación de mercancía asociada a la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

IncotermID

uuid

Descripción: Identificador del incoterm de la transacción.

Obligatoriedad: Opcional

Tipo de dato: GUID

Items

array of objects

Descripción: Detalle de artículos/servicios de la transacción.

Obligatoriedad: Opcional

Tipo de dato: Listado (SA_Trans_Items)

Items

Accounts

array of objects

Descripción: Detalle del asiento contable de la transacción.

Obligatoriedad: Opcional

Tipo de dato: Listado (SA_Trans_Accounts)

Accounts

Files

array of objects

Descripción: Archivos adjuntos de la transacción.

Obligatoriedad: Opcional

Tipo de dato: Listado (SA_Files)

Files

CustomFields

array of objects

Descripción: Valores de los campos personalizados definidos para la transacción.

Obligatoriedad: Opcional

Tipo de dato: Listado (SA_Transactions_CustomFieldDefinitions)

CustomFields

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Response

200El identificador (GUID) de la factura de proveedor creada.