Actualiza un cliente existente

put

https://api.admcloud.net/api/Customers

Valida y guarda los cambios de un cliente existente. El registro debe incluir su identificador.

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

Datos del cliente a actualizar (debe incluir su identificador).

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

Name

string

length between 0 and 200

Descripción: Razón social del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

Code

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

FiscalID

string

length between 0 and 200

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

Obligatoriedad: Opcional

Tipo de dato: String

FiscalIDType

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:

IsRelated

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

IsCustomer

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

IsVendor

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

IsPartner

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

IsDriver

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

IncludeInTransportationVendorBillGeneration

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

Phone1

string

length between 0 and 200

Descripción: Teléfono principal del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

Phone1Extension

string

length between 0 and 50

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

Obligatoriedad: Opcional

Tipo de dato: String

Phone2

string

length between 0 and 200

Descripción: Teléfono secundario del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

Phone2Extension

string

length between 0 and 50

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

Obligatoriedad: Opcional

Tipo de dato: String

MobilePhone

string

length between 0 and 200

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

Obligatoriedad: Opcional

Tipo de dato: String

Fax

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

Notes

string

Descripción: Observaciones del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

AdmCloudID

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

AdmCloudSubsidiaryID

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

SyncItemsBetweenCompanies

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

LanguageID

uuid

Descripción: Identificador del idioma del relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

Inactive

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

CountryID

string

length between 0 and 3

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

Obligatoriedad: Opcional

Tipo de dato: String

DiscountPercent

double

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

Obligatoriedad: Opcional

Tipo de dato: Decimal

CustomerPortalSalesOrdersRequiredAuthorizations

int32

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

Obligatoriedad: Opcional

Tipo de dato: Int32

WebPage

string

length between 0 and 200

Descripción: Página web del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

Facebook

string

length between 0 and 200

Descripción: Perfil de Facebook del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

Twitter

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

PaymentTermID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

EmployeeQuantity

int32

Descripción: Cantidad de empleados del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Int32

PotentialVolume

double

Descripción: Volumen potencial de negocio del relacionado.

Obligatoriedad: Opcional

Tipo de dato: Decimal

Profile

string

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

Obligatoriedad: Opcional

Tipo de dato: String

CurrencyID

string

length between 0 and 3

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

Obligatoriedad: Opcional

Tipo de dato: String

TaxSystemID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

TaxScheduleID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

TaxExempt

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

TaxRetentionGroupID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

TaxRetentionTypeID

string

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

Obligatoriedad: Opcional

Tipo de dato: String

ComercialName

string

length between 0 and 200

Descripción: Nombre comercial del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

BusinessActivity

string

length between 0 and 200

Descripción: Actividad comercial del relacionado.

Obligatoriedad: Opcional

Tipo de dato: String

ParentRelationshipID

uuid

Descripción: Identificador del relacionado padre.

Obligatoriedad: Opcional

Tipo de dato: GUID

NoCredit

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

CreditLimit

double

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

Obligatoriedad: Opcional

Tipo de dato: Decimal

SalesTerritoryID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

CustomerClassID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

AcquisitionSourceID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

SalesRepID

uuid

Descripción: Identificador del vendedor asignado al relacionado.

Obligatoriedad: Opcional

Tipo de dato: GUID

PriceLevelID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

MultiplePriceLevels

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

Prospect

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

ItemClassID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

SalesFiscalSequenceTypeID

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

PaymentMethodID

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:

DefaultPaymentMethodID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

BankAccountNumber

string

length between 0 and 200

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

Obligatoriedad: Opcional

Tipo de dato: String

BankAccountCurrencyID

string

length between 0 and 3

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

Obligatoriedad: Opcional

Tipo de dato: String

BankID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

BankAccountType

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:

PaymentsBankAccountID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

VendorClassID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

PurchasesFiscalSequenceTypeID

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

PurchasesCreditsFiscalSequenceTypeID

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

PurchasesDebitsFiscalSequenceTypeID

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

DocumentToGenerateWhenBillingPayroll

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:

SalesDebitsFiscalSequenceTypeID

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

SalesCreditsFiscalSequenceTypeID

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

PaymentsFiscalSequenceTypeID

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

PurchaseTransitAccountID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

EnforcePurchaseTransitAccount

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

RequirePurchaseOrder

boolean

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

Obligatoriedad: Opcional

Tipo de dato: Boolean

CreationDate

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)

LocationID

uuid

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

Obligatoriedad: Opcional

Tipo de dato: GUID

IncludeInAnomalyAnalysis

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

200El identificador (GUID) del cliente actualizado.