API Reference

Crea un nuevo proveedor

post
https://api.admcloud.net/api/Vendors

Valida y guarda un nuevo proveedor. Devuelve el identificador (GUID) del registro creado.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Nombre de la base de datos de la empresa.

Obligatoriedad: Opcional

Tipo de dato: String

string

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

Obligatoriedad: Opcional

Tipo de dato: String

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

string

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

Obligatoriedad: Opcional

Tipo de dato: String

Body Params

Datos del proveedor a crear.

Obligatoriedad: Requerido

Tipo de dato: SA_Relationships

uuid

Descripción: Identificador del relacionado.

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

Tipo de dato: GUID

string
length between 0 and 200

Descripción: Razón social del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Código del relacionado. Si se omite, el sistema lo genera según la numeración configurada.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Identificación fiscal (RNC/ID fiscal) del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

int32
enum

Descripción: Tipo de identificación fiscal del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Enumerador. Posibles valores: Del 0 al 5


0 --> Sin especificar
1 --> ID empresa
2 --> ID personal
3 --> Pasaporte/Otro
4 --> Carnet de migración
5 --> Interior y policía

Allowed:
boolean

Descripción: Indica si el relacionado es una empresa relacionada (vinculada).

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el relacionado es un cliente.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el relacionado es un proveedor.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el relacionado es un asociado comercial.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el relacionado es un transportista/conductor.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el proveedor se incluye en la generación de facturas de transporte.

Obligatoriedad: Opcional

Tipo de dato: Boolean

string
length between 0 and 200

Descripción: Teléfono principal del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 50

Descripción: Extensión del teléfono principal.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Teléfono secundario del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 50

Descripción: Extensión del teléfono secundario.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Teléfono móvil del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Número de fax del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Correo electrónico del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string

Descripción: Observaciones del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 50

Descripción: Identificador de la compañía en AdmCloud para el intercambio de documentos entre empresas.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 50

Descripción: Identificador de la subsidiaria en AdmCloud para el intercambio de documentos entre empresas.

Obligatoriedad: Opcional

Tipo de dato: String

boolean

Descripción: Indica si se sincronizan los artículos entre empresas al recibir documentos.

Obligatoriedad: Opcional

Tipo de dato: Boolean

uuid

Descripción: Identificador del idioma del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si el relacionado está inactivo.

Obligatoriedad: Opcional

Tipo de dato: Boolean

string
length between 0 and 3

Descripción: Identificador del país del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

double

Descripción: Porcentaje de descuento por defecto del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Decimal

int32

Descripción: Cantidad de autorizaciones requeridas para los pedidos del portal de clientes.

Obligatoriedad: Opcional

Tipo de dato: Int32

string
length between 0 and 200

Descripción: Página web del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Perfil de Facebook del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Perfil de Twitter del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Perfil de LinkedIn del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Identificador del término de pago del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

int32

Descripción: Cantidad de empleados del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Int32

double

Descripción: Volumen potencial de negocio del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Decimal

string

Descripción: Descripción del perfil del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 3

Descripción: Identificador de la moneda por defecto del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Identificador del régimen fiscal del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador del grupo de impuestos del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si el relacionado está exento de impuestos.

Obligatoriedad: Opcional

Tipo de dato: Boolean

uuid

Descripción: Identificador del grupo de retención de impuestos del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

string

Descripción: Identificador del tipo de retención de ISR transportista del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Nombre comercial del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 200

Descripción: Actividad comercial del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Identificador del relacionado padre.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si el relacionado no tiene crédito habilitado.

Obligatoriedad: Opcional

Tipo de dato: Boolean

double

Descripción: Límite de crédito del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Decimal

uuid

Descripción: Identificador del territorio de ventas del cliente.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador de la categoría del cliente.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador de la fuente de captación del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador del vendedor asignado al relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador del nivel de precios asignado al relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si el relacionado puede utilizar múltiples niveles de precios.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si el relacionado es un prospecto.

Obligatoriedad: Opcional

Tipo de dato: Boolean

uuid

Descripción: Identificador de la línea de negocio asociada al relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para las ventas del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

int32
enum

Descripción: Método de pago por defecto del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Enumerador. Posibles valores: Del 0 al 3


0 --> Cheque
1 --> Efectivo
2 --> Transferencia
3 --> Cheque de administración

Allowed:
uuid

Descripción: Identificador del modo de pago por defecto para facturas.

Obligatoriedad: Opcional

Tipo de dato: GUID

string
length between 0 and 200

Descripción: Número de cuenta bancaria del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 3

Descripción: Identificador de la moneda de la cuenta bancaria del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Identificador del banco de la cuenta bancaria del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

int32
enum

Descripción: Tipo de cuenta bancaria del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Enumerador. Posibles valores: Del 0 al 2


0 --> Sin especificar
1 --> Corriente
2 --> Ahorro

Allowed:
uuid

Descripción: Identificador de la cuenta bancaria usada para los pagos del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

uuid

Descripción: Identificador de la categoría del proveedor.

Obligatoriedad: Opcional

Tipo de dato: GUID

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para las compras del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para créditos en compras del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para débitos en compras del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

int32
enum

Descripción: Documento que se genera al facturar la nómina del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Enumerador. Posibles valores: Del 0 al 1


0 --> Cotización
1 --> Factura a crédito

Allowed:
string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para débitos en ventas del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para créditos en ventas del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

string
length between 0 and 10

Descripción: Tipo de secuencia de comprobante fiscal para los pagos/recibos de ingreso del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Cuenta contable de gastos/compras en tránsito.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si se obliga a usar la cuenta de gastos/compras en tránsito indicada.

Obligatoriedad: Opcional

Tipo de dato: Boolean

boolean

Descripción: Indica si las compras al proveedor deben registrarse a partir de una orden de compra.

Obligatoriedad: Opcional

Tipo de dato: Boolean

date-time

Descripción: Fecha de creación del registro del relacionado. Si se omite, toma la fecha actual.

Obligatoriedad: Opcional

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

uuid

Descripción: Identificador de la ubicación del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

boolean

Descripción: Indica si el relacionado se incluye en el análisis de anomalías.

Obligatoriedad: Opcional

Tipo de dato: Boolean

Contacts
array of objects

Descripción: Contactos asociados al relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Contacts)

Contacts
Addresses
array of objects

Descripción: Direcciones asociadas al relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_Addresses)

Addresses
Subsidiaries
array of objects

Descripción: Subsidiarias a las que pertenece el relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_Subsidiaries)

Subsidiaries
ItemPrices
array of objects

Descripción: Precios de artículos específicos configurados para el relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_Item_Prices)

ItemPrices
ItemClassDiscounts
array of objects

Descripción: Descuentos por línea de negocio configurados para el relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_ItemClass_Discount)

ItemClassDiscounts
CustomFields
array of objects

Descripción: Campos personalizados definidos para el relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_CustomFieldDefinitions)

CustomFields
Files
array of objects

Descripción: Archivos adjuntos del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Files)

Files
Branches
array of objects

Descripción: Sucursales asociadas al relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_Branches)

Branches
Accounts
array of objects

Descripción: Cuentas contables asociadas al relacionado.

Obligatoriedad: Opcional

Tipo de dato: Listado de objetos (SA_Relationships_Accounts)

Accounts
string

Descripción: Etiquetas asociadas al relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

uuid

Descripción: Identificador del contacto principal del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Updated 23 days ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json

Updated 23 days ago

Did this page help you?