---
title: "Crear un contacto"
method: POST
path: "/contacts"
tags: ["Contactos"]
---

# Crear un contacto

`POST /contacts`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/contacts`
- Auth: HTTP basic

Endpoint que permite crear un contacto en la aplicación

## Request body

- union
  - object
    - `name` string, required: Nombre del contacto.
    - `identification` string: Identificacion del contacto.
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad
      - `address` string: Dirección
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contacto con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identification` string: Identificacion del contacto.
    - `giro` string: Giro
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad
      - `region` string: Región
      - `commune` string: Comuna
      - `description` string: Dirección
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identification` string, required: Identificacion del contacto.
    - `giro` string, required: Giro
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad
      - `region` string, required: Región
      - `commune` string, required: Comuna
      - `description` string, required: Dirección
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación
      - `type` 'CUIT' | 'CDI' | 'CI' | 'PASSPORT' | 'DNI' | 'OTHER': Tipo de identificación: * `CUIT` - CUIT * `CDI` - CDI * `CI` - CI Extranjera * `PASSPORT` - Pasaporte * `DNI` - DNI * `OTHER` - Otro
    - `ivaCondition` 'IVA_RESPONSABLE' | 'IVA_EXEMPT' | 'FINAL_CONSUMER' | 'UNIQUE_TRIBUTE_RESPONSABLE' | 'PROVIDER_FROM_EXTERIOR' | 'CLIENT_FROM_EXTERIOR' | 'IVA_RELEASED_LAW_19640' | 'UNIQUE_TRIBUTE_SOCIAL' | 'IVA_NOT_REACHED', required: Condición de IVA: * `IVA_RESPONSABLE` - IVA responsable inscripto * `IVA_EXEMPT` - IVA sujeto exento * `FINAL_CONSUMER` - Consumidor final * `UNIQUE_TRIBUTE_RESPONSABLE` - Responsable monotributo * `PROVIDER_FROM_EXTERIOR` - Proveedor del exterior * `CLIENT_FROM_EXTERIOR` - Cliente del exterior * `IVA_RELEASED_LAW_19640` - IVA Liberado - Ley 19.640 * `UNIQUE_TRIBUTE_SOCIAL` - Monotributista Social * `IVA_NOT_REACHED` - IVA No alcanzado
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad
      - `province` string: Provincia
      - `address` string: Dirección
      - `postalCode` string: Código postal
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string, required: Número de identificación
      - `type` 'CUIT' | 'CDI' | 'CI' | 'PASSPORT' | 'DNI' | 'OTHER', required: Tipo de identificación: * `CUIT` - CUIT * `CDI` - CDI * `CI` - CI Extranjera * `PASSPORT` - Pasaporte * `DNI` - DNI * `OTHER` - Otro
    - `ivaCondition` 'IVA_RESPONSABLE' | 'IVA_EXEMPT' | 'FINAL_CONSUMER' | 'UNIQUE_TRIBUTE_RESPONSABLE' | 'PROVIDER_FROM_EXTERIOR' | 'CLIENT_FROM_EXTERIOR' | 'IVA_RELEASED_LAW_19640' | 'UNIQUE_TRIBUTE_SOCIAL' | 'IVA_NOT_REACHED': Condición de IVA: * `IVA_RESPONSABLE` - IVA responsable inscripto * `IVA_EXEMPT` - IVA sujeto exento * `FINAL_CONSUMER` - Consumidor final * `UNIQUE_TRIBUTE_RESPONSABLE` - Responsable monotributo * `PROVIDER_FROM_EXTERIOR` - Proveedor del exterior * `CLIENT_FROM_EXTERIOR` - Cliente del exterior * `IVA_RELEASED_LAW_19640` - IVA Liberado - Ley 19.640 * `UNIQUE_TRIBUTE_SOCIAL` - Monotributista Social * `IVA_NOT_REACHED` - IVA No alcanzado
    - `address` object: Dirección del contaco.
      - `city` string, required: Ciudad
      - `province` string, required: Provincia
      - `address` string: Dirección
      - `postalCode` string: Código postal
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string: Nombre del contacto. (Obligatorio si el tipo de persona no es PERSON_ENTITY)
    - `nameObject` object: (Obligatorio si el tipo de persona es PERSON_ENTITY)
      - `firstName` string, required: Primer nombre del contacto.
      - `secondName` string: Segundo nombre del contacto.
      - `lastName` string, required: Apellidos del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación: * `NIT` - Número de identificación tributaria: Formato: numérico * `CC` - Cédula de ciudadanía Formato: numérico * `TI` - Tarjeta de identidad Formato: numérico
      - `dv` string: Dígito de verificación
      - `type` 'NIT' | 'CC' | 'DIE' | 'PP' | 'CE' | 'TE' | 'TI' | 'RC' | 'FOREIGN_NIT' | 'NUIP': Tipo de identificación: * `NIT` - Número de identificación tributaria * `CC` - Cédula de ciudadanía * `DIE` - Documento de identificación extranjero * `PP` - Pasaporte * `CE` - Cédula de extranjería * `TE` - Tarjeta de extranjería * `TI` - Tarjeta de identidad * `RC` - Registro civil * `FOREIGN_NIT` - NIT de otro país * `NUIP` - NUIP
    - `kindOfPerson` 'LEGAL_ENTITY' | 'PERSON_ENTITY' | 'OTHER_ENTITY': Tipo de persona: * `LEGAL_ENTITY` - Persona jurídica * `PERSON_ENTITY` - Persona natural * `OTHER_ENTITY` - Otro tipo de obligado
    - `regime` 'COMMON_REGIME' | 'SIMPLIFIED_REGIME' | 'NATIONAL_CONSUMPTION_TAX' | 'NOT_REPONSIBLE_FOR_CONSUMPTION' | 'INC_IVA_RESPONSIBLE' | 'SPECIAL_REGIME': Regimen: * `COMMON_REGIME` - Responsable de IVA * `SIMPLIFIED_REGIME` - No responsable de IVA * `NATIONAL_CONSUMPTION_TAX` - Impuesto Nacional al Consumo - INC * `NOT_REPONSIBLE_FOR_CONSUMPTION` - No responsable de INC * `INC_IVA_RESPONSIBLE` - Responsable de IVA e INC * `SPECIAL_REGIME` - Régimen especial
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad
      - `department` string: Departamento
      - `address` string: Dirección
      - `zipCode` string: Código postal
      - `country` string: País (solo es necesario si el tipo de identificación es extranjero)
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `emailSecondary` string: Email secundario del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `fiscalResponsabilities` string[]: Responsabilidades fiscales.
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string: Nombre del contacto. (Obligatorio si el tipo de persona no es PERSON_ENTITY)
    - `nameObject` object: (Obligatorio si el tipo de persona es PERSON_ENTITY)
      - `firstName` string, required: Primer nombre del contacto.
      - `secondName` string: Segundo nombre del contacto.
      - `lastName` string, required: Apellidos del contacto.
    - `identificationObject` object, required: Identificacion del contacto.
      - `number` string, required: Número de identificación: * `NIT` - Número de identificación tributaria: Formato: numérico * `CC` - Cédula de ciudadanía Formato: numérico * `TI` - Tarjeta de identidad Formato: numérico
      - `dv` string: Dígito de verificación (Obligatorio si tipo de identificación es NIT)
      - `type` 'NIT' | 'CC' | 'DIE' | 'PP' | 'CE' | 'TE' | 'TI' | 'RC' | 'FOREIGN_NIT' | 'NUIP', required: Tipo de identificación: * `NIT` - Número de identificación tributaria * `CC` - Cédula de ciudadanía * `DIE` - Documento de identificación extranjero * `PP` - Pasaporte * `CE` - Cédula de extranjería * `TE` - Tarjeta de extranjería * `TI` - Tarjeta de identidad * `RC` - Registro civil * `FOREIGN_NIT` - NIT de otro país * `NUIP` - NUIP
    - `kindOfPerson` 'LEGAL_ENTITY' | 'PERSON_ENTITY' | 'OTHER_ENTITY', required: Tipo de persona: * `LEGAL_ENTITY` - Persona jurídica * `PERSON_ENTITY` - Persona natural * `OTHER_ENTITY` - Otro tipo de obligado
    - `regime` 'COMMON_REGIME' | 'SIMPLIFIED_REGIME' | 'NATIONAL_CONSUMPTION_TAX' | 'NOT_REPONSIBLE_FOR_CONSUMPTION' | 'INC_IVA_RESPONSIBLE' | 'SPECIAL_REGIME', required: Regimen: * `COMMON_REGIME` - Responsable de IVA * `SIMPLIFIED_REGIME` - No responsable de IVA * `NATIONAL_CONSUMPTION_TAX` - Impuesto Nacional al Consumo - INC * `NOT_REPONSIBLE_FOR_CONSUMPTION` - No responsable de INC * `INC_IVA_RESPONSIBLE` - Responsable de IVA e INC * `SPECIAL_REGIME` - Régimen especial
    - `fiscalResidence` 'RESIDENT' | 'NON_RESIDENT': Este campo es usado para proveedores, identifica si el proveedor es residente o no residente: * `RESIDENT` - Residente * `NON_RESIDENT` - No residente
    - `enableHealthSector` boolean: Este campo identifica si un contacto tiene habilitado el sector salud, el mismo que debe tener configurado un paciente en el campo `healthPatients`.
    - `healthPatients` object: Arreglo de objetos necesario al tener el parámetro `enableHealthSector (boolean)` en `true` que tiene toda la información de los pacientes. Se debe enviar el arreglo con objeto con los siguientes atributos:
      - `firstName` string: Primer nombre
      - `secondName` string: Segundo nombre
      - `lastName` string: Apellido
      - `identification` string: Identificación
      - `identificationObject` object: Ojeto de identificación incluye los siguientes campos
        - `type` 'AS' | 'CD' | 'CN' | 'CC' | 'CE' | 'DI' | 'MS' | 'PP' | 'PE' | 'RC' | 'SC': Tipo de identificación del paciente: * `AS` - Adulto sin identificar * `CD` - Carné diplomático * `CN` - Certificado de nacido vivo * `CC` - Cédula de ciudadanía * `CE` - Cédula de extranjería * `DI` - "Documento extranjero * `MS` - Menor sin identificar * `PP` - Pasaporte * `PE` - "Permiso especial de permanencia * `RC` - Registro civil * `SC` - Salvoconducto"SI"Sin identificación"TI"Tarjeta de identidad
        - `number` string: Tipo de identificación del paciente
      - `benefitPlan` 'PBSF' | 'PM' | 'PESP' | 'CPSOAT' | 'CARL' | 'CADRES' | 'CSP' | 'CET' | 'UPM' | 'PCS' | 'PCP' | 'OPS' | 'CREE' | 'CFNSPPL' | 'PA': Planes de beneficios: * `PBSF` - Plan de beneficios en salud financiado por UPC * `PM` - Presupuesto máximo * `PESP` - Prima EPS/EOC, no asegurados SOAT * `CPSOAT` - Cobertura Póliza SOAT * `CARL` - Cobertura ARL * `CADRES` - Cobertura ADRES * `CSP` - Cobertura Salud Pública * `CET` - Cobertura entidad territorial, recursos de oferta * `UPM` - Urgencias población migrante * `PCS` - Plan complementario en salud * `PCP` - Plan medicina prepagada * `OPS` - Otras pólizas en salud * `CREE` - Cobertura Régimen Especial o Excepción * `CFNSPPL` - Cobertura Fondo Nacional de Salud de las Personas Privadas de la Libertad * `PA` - Particular
      - `patientType` 'CA' | 'CB' | 'CA' | 'SU' | 'SR' | 'EEC' | 'EEB' | 'PA' | 'ARL' | 'SOAT' | 'PVS': Tipo de paciente: * `CC` - Contribuyente cotizante * `CB` - Contributivo beneficiario * `CA` - Contributivo adicional * `SU` - Subsidiado * `SR` - Sin regimen * `EEC` - Especiales o de Excepción cotizante * `EEB` - Especiales o de Excepción beneficiario * `PA` - Particular * `ARL` - Tomador/Amparado ARL * `SOAT` - Tomador/Amparado SOAT * `PVS` - Tomador/Amparado Planes voluntarios de salud
      - `methodOfPayment` 'PICCIPCP' | 'PGP' | 'PPC' | 'PE' | 'OME': Metodos de pago: * `PICCIPCP` - Pago individual por caso / Conjunto integral de atenciones / Paquete / Canasta * `PGP` - Pago global prospectivo * `PPC` - Pago por capitación * `PE` - Por evento * `OME` - Otra modalidad (específica)
    - `address` object: Dirección del contaco.
      - `city` string: Ciudad (Obligatorio si el tipo de identificación es nacional)
      - `department` string: Departamento (Obligatorio si el tipo de identificación es nacional)
      - `address` string: Dirección (Obligatorio si el tipo de identificación es nacional)
      - `zipCode` string: Código postal
      - `country` string: País (Obligatorio si el tipo de identificación es extranjero)
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `emailSecondary` string: Email secundario del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` integer: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` integer: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `fiscalResponsabilities` string[]: Responsabilidades fiscales.
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación: * `CF` - Formato: 9 dígitos. No puede comenzar con 0 * `CJ` - Formato: 10 dígitos * `DIMEX` - Formato: 11 o 12 dígitos. No puede comenzar con 0 * `NITE` - Formato: 10 dígitos * `PE` - Longitud máxima permitida: 20 * `COF` - Campo libre (No es obligatorio)
      - `type` 'CF' | 'CJ' | 'DIMEX' | 'NITE' | 'PE': Tipo de identificación: * `CF` - Cédula Física * `CJ` - Cédula Jurídica * `DIMEX` - DIMEX * `NITE` - NITE * `PE` - Identificación extranjero * `COF` - Consumidor final
    - `address` object: Dirección del contaco.
      - `department` string: Provincia
      - `city` string: Cantón
      - `district` string: Distrito
      - `neighborhood` string: Barrio
      - `address` string: Dirección
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `exoneration` object[]: Responsabilidades fiscales.
      - `documentNumber` string, required: Número del documento
      - `documentType` string, required: Tipo de documento
      - `dueDate` string, required: Fecha de vencimiento
      - `emissionDate` string, required: Fecha de emisión
      - `institutionName` string, required: Nombre de institución
      - `percentage` integer, required: Porcentaje
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `exporter` boolean: Indica si se el contacto es exportador
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object, required: Identificacion del contacto.
      - `number` string, required: Número de identificación: * `CF` - Formato: 9 dígitos. No puede comenzar con 0 * `CJ` - Formato: 10 dígitos * `DIMEX` - Formato: 11 o 12 dígitos. No puede comenzar con 0 * `NITE` - Formato: 10 dígitos * `PE` - Longitud máxima permitida: 20 * `COF` - Campo libre (No es obligatorio)
      - `type` 'CF' | 'CJ' | 'DIMEX' | 'NITE' | 'PE', required: Tipo de identificación: * `CF` - Cédula Física * `CJ` - Cédula Jurídica * `DIMEX` - DIMEX * `NITE` - NITE * `PE` - Identificación extranjero * `COF` - Consumidor final
    - `address` object: Dirección del contaco.
      - `department` string, required: Provincia
      - `city` string, required: Cantón
      - `district` string, required: Distrito
      - `neighborhood` string: Barrio
      - `address` string, required: Dirección
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `exoneration` object[]: Responsabilidades fiscales.
      - `documentNumber` string, required: Número del documento
      - `documentType` string, required: Tipo de documento
      - `dueDate` string, required: Fecha de vencimiento
      - `emissionDate` string, required: Fecha de emisión
      - `institutionName` string, required: Nombre de institución
      - `percentage` integer, required: Porcentaje
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `exporter` boolean: Indica si se el contacto es exportador
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identification` string: Identificación del contacto. Si el tipo de tercero es Extranjero (FOREIGN), su valor debe ser XEXX010101000 Máxima longitud: 45
    - `fiscalId` string: Obligatorio si el tipo de tercero es Extranjero (FOREIGN)
    - `thirdType` 'FOREIGN' | 'NATIONAL', required: Tipo de tercero: * `FOREIGN` - Extranjero * `NATIONAL` - Nacional
    - `paymentType` 'PUE' | 'PPD': Método de pago: * `PUE` - Pago en Una sola Exhibición * `PPD` - Pago en Parcialidades o Diferido
    - `operationType` 'PROFESSIONAL_SERVICES' | 'PROPERTY_LEASING' | 'OTHERS': Tipo de operación (solo si es tipo de cliente proveedor ): * `PROFESSIONAL_SERVICES` - Prestación de servicios profesionales * `PROPERTY_LEASING` - Arrendamiento de inmuebles * `OTHERS` - Otros
    - `regime` 'NO_REGIME' | 'BUSINESS_ACTIVITIES_REGIME' | 'FISCAL_INCORPORATION_REGIME' | 'LEASEHOLD_REGIME' | 'REGIME_OF_THE_TECHNOLOGICAL_PLATFORMS_INCOME_ACTIVITIES' | 'SALARIED_REGIME' | 'GENERAL_REGIME_OF_MORAL_PEOPLE_LAW' | 'REGIME_OF_MORAL_PEOPLE_NOT_PROFIT' | 'PRIMARY_SECTOR_REGIME' | 'REGIME_OF_THE_COORDINATED' | 'REGIME_OF_COOPERATIVE_PRODUCTION_SOCIETIES' | 'REGIME_OF_TRUST' | 'SIMPLIFIED_REGIME' | 'SOCIETIES_OPTIONAL_REGIME' | 'DIVIDEND_INCOME': Régimen fiscal. Si el RFC tiene 12 caracteres las opciones permitidas son: * `NO_REGIME` - Sin régimen * `GENERAL_REGIME_OF_MORAL_PEOPLE_LAW` - General de Ley Personas Morales * `REGIME_OF_MORAL_PEOPLE_NOT_PROFIT` - Personas Morales con Fines no Lucrativos * `PRIMARY_SECTOR_REGIME` - Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras (AGAPES) * `REGIME_OF_THE_COORDINATED` - Coordinados * `REGIME_OF_COOPERATIVE_PRODUCTION_SOCIETIES` - Sociedades Cooperativas de Producción que optan por diferir sus ingresos * `REGIME_OF_TRUST` - Regimen simplificado de confianza (RESICO) * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales * `SOCIETIES_OPTIONAL_REGIME` - Opcional para Grupos de Sociedades Si el RFC tiene 13 caracteres las opciones permitidas son: * `NO_REGIME` - Sin régimen * `BUSINESS_ACTIVITIES_REGIME` - Personas Físicas con Actividades Empresariales y Profesionales * `FISCAL_INCORPORATION_REGIME` - Incorporación Fiscal * `LEASEHOLD_REGIME` - Arrendamiento * `REGIME_OF_THE_TECHNOLOGICAL_PLATFORMS_INCOME_ACTIVITIES` - Régimen de las Actividades Empresariales con ingresos a través de Plataformas Tecnológicas * `SALARIED_REGIME` - Sueldos y Salarios e Ingresos Asimilados a Salarios * `REGIME_OF_TRUST` - Regimen simplificado de confianza (RESICO) * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales * `DIVIDEND_INCOME` - Ingresos por Dividendos (socios y accionistas) Si no se ingresa el RFC la única opción permitida es: * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales
    - `regimeObject` string[]: Listado de regimenes fiscales.
    - `paymentMethod` 'cash' | 'debit-card' | 'credit-card' | 'service-card' | 'transfer' | 'check' | 'electronic-wallet' | 'electronic-money' | 'grocery-voucher' | 'dation-payment' | 'subrogation-payment' | 'allocation-payment' | 'forgiveness' | 'compensation' | 'novation' | 'misunderstanding' | 'debt-remission' | 'prescription-or-expiration' | 'creditor-satisfaction' | 'other' | 'payment-intermediary': Forma de pago: * `cash` - Efectivo * `debit-card` - Tarjeta de débito * `credit-card` - Tarjeta de crédito * `service-card` - Tarjeta de servicios * `transfer` - Transferencia electrónica de fondos * `check` - Cheque nominativo * `electronic-wallet` - Monedero electrónico * `electronic-money` - Dinero electrónico * `grocery-voucher` - Vale de despensa * `dation-payment` - Dación en pago * `subrogation-payment` - Pago por subrogación * `allocation-payment` - Pago por consignación * `forgiveness` - Condonación * `compensation` - Compensación * `novation` - Novación * `misunderstanding` - Confusión * `debt-remission` - Remisión de deuda * `prescription-or-expiration` - Prescripción o caducidad * `creditor-satisfaction` - A satisfacción del acreedor * `other` - Otro * `payment-intermediary` - Intermediario pagos
    - `cfdiUse` 'G01' | 'G03' | 'I01' | 'I02' | 'G03' | 'I03' | 'I04' | 'I05' | 'I06' | 'I07' | 'I08' | 'D01' | 'D02' | 'D03' | 'D04' | 'D05' | 'D06' | 'D07' | 'D08' | 'D09' | 'D10' | 'P01': Tipo de tercero: * `G01` - Adquisición de mercancias * `G03` - Gastos en general * `I01` - Construcciones * `I02` - Mobilario y equipo de oficina por inversiones * `I03` - Equipo de transporte * `I04` - Equipo de computo y accesorios * `I05` - Dados, troqueles, moldes, matrices y herramental * `I06` - Comunicaciones telefónicas * `I07` - Comunicaciones satelitales * `I08` - Otra maquinaria y equipo * `D01` - Honorarios médicos, dentales y gastos hospitalarios. * `D02` - Gastos médicos por incapacidad o discapacidad * `D03` - Gastos funerales * `D04` - Donativos * `D05` - Intereses reales efectivamente pagados por créditos hipotecarios (casa habitación) * `D06` - Aportaciones voluntarias al SAR * `D07` - Primas por seguros de gastos médicos * `D08` - Gastos de transportación escolar obligatoria * `D09` - Depósitos en cuentas para el ahorro, primas que tengan como base planes de pensiones * `D10` - Pagos por servicios educativos (colegiaturas) * `P01` - Por definir
    - `address` object: Dirección del contaco.
      - `street` string: Calle
      - `exteriorNumber` string: Número exterior
      - `interiorNumber` string: Número exterior
      - `colony` string: Colonia
      - `locality` string: Localidad
      - `municipality` string: Municipio/delegación
      - `state` string: Estado
      - `zipCode` string: Código postal (Formato: 5 dígitos)
      - `country` string, required: País * `NATIONAL` - Debe tener el valor MEX * `FOREIGN` - Debe tener cualquier país excepto MEX
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Filtrar resultados según estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identification` string: Identificación del contacto. Si el tipo de tercero es Extranjero (FOREIGN), su valor debe ser XEXX010101000 Máxima longitud: 45
    - `fiscalId` string: Obligatorio si el tipo de tercero es Extranjero (FOREIGN)
    - `thirdType` 'FOREIGN' | 'NATIONAL', required: Tipo de tercero: * `FOREIGN` - Extranjero * `NATIONAL` - Nacional
    - `paymentType` 'PUE' | 'PPD': Método de pago: * `PUE` - Pago en Una sola Exhibición * `PPD` - Pago en Parcialidades o Diferido
    - `operationType` 'PROFESSIONAL_SERVICES' | 'PROPERTY_LEASING' | 'OTHERS': Tipo de operación (solo si es tipo de cliente proveedor ): * `PROFESSIONAL_SERVICES` - Prestación de servicios profesionales * `PROPERTY_LEASING` - Arrendamiento de inmuebles * `OTHERS` - Otros
    - `regime` 'NO_REGIME' | 'BUSINESS_ACTIVITIES_REGIME' | 'FISCAL_INCORPORATION_REGIME' | 'LEASEHOLD_REGIME' | 'REGIME_OF_THE_TECHNOLOGICAL_PLATFORMS_INCOME_ACTIVITIES' | 'SALARIED_REGIME' | 'GENERAL_REGIME_OF_MORAL_PEOPLE_LAW' | 'REGIME_OF_MORAL_PEOPLE_NOT_PROFIT' | 'PRIMARY_SECTOR_REGIME' | 'REGIME_OF_THE_COORDINATED' | 'REGIME_OF_COOPERATIVE_PRODUCTION_SOCIETIES' | 'REGIME_OF_TRUST' | 'SIMPLIFIED_REGIME' | 'SOCIETIES_OPTIONAL_REGIME' | 'DIVIDEND_INCOME', required: Régimen fiscal favorito. Si el RFC tiene 12 caracteres las opciones permitidas son: * `NO_REGIME` - Sin régimen * `GENERAL_REGIME_OF_MORAL_PEOPLE_LAW` - General de Ley Personas Morales * `REGIME_OF_MORAL_PEOPLE_NOT_PROFIT` - Personas Morales con Fines no Lucrativos * `PRIMARY_SECTOR_REGIME` - Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras (AGAPES) * `REGIME_OF_THE_COORDINATED` - Coordinados * `REGIME_OF_COOPERATIVE_PRODUCTION_SOCIETIES` - Sociedades Cooperativas de Producción que optan por diferir sus ingresos * `REGIME_OF_TRUST` - Regimen simplificado de confianza (RESICO) * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales * `SOCIETIES_OPTIONAL_REGIME` - Opcional para Grupos de Sociedades Si el RFC tiene 13 caracteres las opciones permitidas son: * `NO_REGIME` - Sin régimen * `BUSINESS_ACTIVITIES_REGIME` - Personas Físicas con Actividades Empresariales y Profesionales * `FISCAL_INCORPORATION_REGIME` - Incorporación Fiscal * `LEASEHOLD_REGIME` - Arrendamiento * `REGIME_OF_THE_TECHNOLOGICAL_PLATFORMS_INCOME_ACTIVITIES` - Régimen de las Actividades Empresariales con ingresos a través de Plataformas Tecnológicas * `SALARIED_REGIME` - Sueldos y Salarios e Ingresos Asimilados a Salarios * `REGIME_OF_TRUST` - Regimen simplificado de confianza (RESICO) * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales * `DIVIDEND_INCOME` - Ingresos por Dividendos (socios y accionistas) Si no se ingresa el RFC la única opción permitida es: * `SIMPLIFIED_REGIME` - Sin obligaciones fiscales
    - `regimeObject` string[], required: Listado de regimenes fiscales.
    - `paymentMethod` 'cash' | 'debit-card' | 'credit-card' | 'service-card' | 'transfer' | 'check' | 'electronic-wallet' | 'electronic-money' | 'grocery-voucher' | 'dation-payment' | 'subrogation-payment' | 'allocation-payment' | 'forgiveness' | 'compensation' | 'novation' | 'misunderstanding' | 'debt-remission' | 'prescription-or-expiration' | 'creditor-satisfaction' | 'other' | 'payment-intermediary': Forma de pago: * `cash` - Efectivo * `debit-card` - Tarjeta de débito * `credit-card` - Tarjeta de crédito * `service-card` - Tarjeta de servicios * `transfer` - Transferencia electrónica de fondos * `check` - Cheque nominativo * `electronic-wallet` - Monedero electrónico * `electronic-money` - Dinero electrónico * `grocery-voucher` - Vale de despensa * `dation-payment` - Dación en pago * `subrogation-payment` - Pago por subrogación * `allocation-payment` - Pago por consignación * `forgiveness` - Condonación * `compensation` - Compensación * `novation` - Novación * `misunderstanding` - Confusión * `debt-remission` - Remisión de deuda * `prescription-or-expiration` - Prescripción o caducidad * `creditor-satisfaction` - A satisfacción del acreedor * `other` - Otro * `payment-intermediary` - Intermediario pagos
    - `cfdiUse` 'G01' | 'G03' | 'I01' | 'I02' | 'G03' | 'I03' | 'I04' | 'I05' | 'I06' | 'I07' | 'I08' | 'D01' | 'D02' | 'D03' | 'D04' | 'D05' | 'D06' | 'D07' | 'D08' | 'D09' | 'D10' | 'P01': Tipo de tercero: * `G01` - Adquisición de mercancias * `G03` - Gastos en general * `I01` - Construcciones * `I02` - Mobilario y equipo de oficina por inversiones * `I03` - Equipo de transporte * `I04` - Equipo de computo y accesorios * `I05` - Dados, troqueles, moldes, matrices y herramental * `I06` - Comunicaciones telefónicas * `I07` - Comunicaciones satelitales * `I08` - Otra maquinaria y equipo * `D01` - Honorarios médicos, dentales y gastos hospitalarios. * `D02` - Gastos médicos por incapacidad o discapacidad * `D03` - Gastos funerales * `D04` - Donativos * `D05` - Intereses reales efectivamente pagados por créditos hipotecarios (casa habitación) * `D06` - Aportaciones voluntarias al SAR * `D07` - Primas por seguros de gastos médicos * `D08` - Gastos de transportación escolar obligatoria * `D09` - Depósitos en cuentas para el ahorro, primas que tengan como base planes de pensiones * `D10` - Pagos por servicios educativos (colegiaturas) * `P01` - Por definir * `S01` - Sin efectos fiscales
    - `address` object, required: Dirección del contaco.
      - `street` string: Calle
      - `exteriorNumber` string: Número exterior
      - `interiorNumber` string: Número exterior
      - `colony` string: Colonia
      - `locality` string: Localidad
      - `municipality` string: Municipio/delegación
      - `state` string: Estado
      - `zipCode` string, required: Código postal (Formato: 5 dígitos)
      - `country` string, required: País * `NATIONAL` - Debe tener el valor MEX * `FOREIGN` - Debe tener cualquier país excepto MEX
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` 'yes' | 'no': Indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `nameObject` object: (Obligatorio si el tipo de persona es PERSON_ENTITY)
      - `firstName` string, required: Primer nombre del contacto.
      - `secondName` string: Segundo nombre del contacto.
      - `lastName` string, required: Primer apellido del contacto.
      - `secondLastName` string: Segundo apellido del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación
      - `dv` string: Dígito verificación
      - `kindOfPerson` 'LEGAL_ENTITY' | 'PERSON_ENTITY': Tipo de persona: * `LEGAL_ENTITY` - Persona jurídica * `PERSON_ENTITY` - Persona natural
    - `address` object: Dirección del contacto.
      - `province` string: Provincia
      - `district` string: Distrito
      - `township` string: Corregimiento
      - `address` string: Dirección
      - `country` string: País
    - `thirdsType` 'TAXPAYER' | 'FINAL_CONSUMER' | 'GOVERNMENT' | 'FOREIGN': Tipo de tercero: * `TAXPAYER` - Contribuyente * `FINAL_CONSUMER` - Consumidor final * `GOVERNMENT` - Gobierno * `FOREIGN` - Extranjero
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `nameObject` object: (Obligatorio si el tipo de persona es PERSON_ENTITY)
      - `firstName` string, required: Primer nombre del contacto.
      - `secondName` string: Segundo nombre del contacto.
      - `lastName` string, required: Primer apellido del contacto.
      - `secondLastName` string: Segundo apellido del contacto.
    - `identificationObject` object, required: Identificacion del contacto.
      - `number` string: Número de identificación * Obligatorio si el tipo de tercero es distinto de FINAL_CONSUMER(Consumidor Final)
      - `dv` string: Dígito verificación (Obligatorio si el tipo de tercero es TAX_PAYER(Contribuyente) o GOVERNMENT(Gobierno))
      - `kindOfPerson` 'LEGAL_ENTITY' | 'PERSON_ENTITY': Tipo de persona: * `LEGAL_ENTITY` - Persona jurídica * `PERSON_ENTITY` - Persona natural Obligatorio si el tipo de tercero no es FOREIGN (Extranjero) o FOREIGN_COMPANY (Empresa Extranjera))
    - `address` object: Dirección del contacto.
      - `province` string, required: Provincia (Obligatorio si tipo de tercero no es FOREIGN (Extranjero) o FOREIGN_COMPANY (Empresa Extranjera))
      - `district` string, required: Distrito (Obligatorio si tipo de tercero no es FOREIGN (Extranjero) o FOREIGN_COMPANY (Empresa Extranjera))
      - `township` string, required: Corregimiento (Obligatorio si tipo de tercero no es FOREIGN (Extranjero) o FOREIGN_COMPANY (Empresa Extranjera))
      - `address` string, required: Dirección
      - `country` string: País (Obligatorio si tipo de tercero es FOREIGN (Extranjero))
    - `thirdsType` 'TAXPAYER' | 'FINAL_CONSUMER' | 'GOVERNMENT' | 'FOREIGN' | 'FOREIGN_COMPANY', required: Tipo de tercero: * `TAXPAYER` - Contribuyente * `FINAL_CONSUMER` - Consumidor final * `GOVERNMENT` - Gobierno * `FOREIGN` - Extranjero * `FOREIGN_COMPANY` - Empresa Extranjera
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string, required: Número de identificación Validación: * `RUC` - Registro único de contribuyente Formato: 11 dígitos * `DNI` - Documento nacional de identidad Formato: 8 dígitos * `CE` - Carnet de extranjería Máxima longitud: 12 * `PP` - Pasaporte Máxima longitud: 12 * `CDI` - Cédula diplomática de identidad Máxima longitud: 15 * `NOT_DOMICILIED_WITHOUT_RUC` - No domiciliado sin RUC: Máxima longitud: 15
      - `type` 'RUC' | 'DNI' | 'CE' | 'PP' | 'CDI' | 'NOT_DOMICILIED_WITHOUT_RUC RUC' | 'DIP' | 'TIN' | 'IN', required: Tipo de identificación: * `RUC` - Registro único de contribuyente * `DNI` - Documento nacional de identidad * `CE` - Carnet de extranjería * `PP` - Pasaporte * `CDI` - Cédula diplomática de identidad * `NOT_DOMICILIED_WITHOUT_RUC` - No domiciliado sin RUC * `DIP` - Documento de identidad país residencia - no domiciliado * `TIN` - Tax Identification Number - Doc Trib PP.NN * `IN` - Identification Number - Doc Trib PP. JJ
    - `address` object: Dirección del contaco.
      - `state` string: Departamento
      - `city` string: Provincia
      - `district` string: Distrito
      - `urbanization` string: Urbanización
      - `ubigeoCode` string: Ubigeo INEI
      - `address` string: Dirección
      - `country` string: País
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string, required: Número de identificación Validación: * `RUC` - Registro único de contribuyente Formato: 11 dígitos * `DNI` - Documento nacional de identidad Formato: 8 dígitos * `CE` - Carnet de extranjería Máxima longitud: 12 * `PP` - Pasaporte Máxima longitud: 12 * `CDI` - Cédula diplomática de identidad Máxima longitud: 15 * `NOT_DOMICILIED_WITHOUT_RUC` - No domiciliado sin RUC: Máxima longitud: 15
      - `type` 'RUC' | 'DNI' | 'CE' | 'PP' | 'CDI' | 'NOT_DOMICILIED_WITHOUT_RUC RUC' | 'DIP' | 'TIN' | 'IN', required: Tipo de identificación: * `RUC` - Registro único de contribuyente * `DNI` - Documento nacional de identidad * `CE` - Carnet de extranjería * `PP` - Pasaporte * `CDI` - Cédula diplomática de identidad * `NOT_DOMICILIED_WITHOUT_RUC` - No domiciliado sin RUC * `DIP` - Documento de identidad país residencia - no domiciliado * `TIN` - Tax Identification Number - Doc Trib PP.NN * `IN` - Identification Number - Doc Trib PP. JJ
    - `address` object: Dirección del contaco.
      - `state` string: Departamento
      - `city` string: Provincia
      - `district` string: Distrito
      - `urbanization` string: Urbanización
      - `ubigeoCode` string: Ubigeo INEI
      - `address` string: Dirección
      - `country` string: País
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación (Obligatorio si el campo type tiene valor): * `RNC` - RNC Formato: Longitud máxima 9 dígitos * `CED` - Cédula Formato: Longitud máxima 11 dígitos * `IE` - Formato: Longitud máxima 25 caracteres
      - `type` 'RNC' | 'CED' | 'IE': Tipo de indentificación: * `RNC` - RNC * `CED` - Cédula * `IE` - Identificador extranjero
    - `address` object: Dirección del contacto.
      - `province` string: Provincia
      - `municipality` string: Municipio
      - `description` string: Dirección
      - `country` string: País
    - `defaultInvoiceResolution` string: Tipo de NCF.
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificacion del contacto.
      - `number` string: Número de identificación (Obligatorio si el campo type tiene valor): * `RNC` - RNC Formato: Longitud máxima 9 dígitos * `CED` - Cédula Formato: Longitud máxima 11 dígitos * `IE` - Formato: Longitud máxima 25 caracteres
      - `type` 'RNC' | 'CED' | 'IE': Tipo de indentificación: * `RNC` - RNC * `CED` - Cédula * `IE` - Identificador extranjero
    - `address` object: Dirección del contacto.
      - `province` string: Provincia (Obligatorio si identificación no es extranjera)
      - `municipality` string: Municipio (Obligatorio si identificación no es extranjera)
      - `description` string: Dirección (Obligatorio si identificación no es extranjera)
      - `country` string: País
    - `defaultInvoiceResolution` string: Tipo de NCF.
    - `phonePrimary` string: Teléfono del contacto. (Formato si indentificación no es extranjera: xxx-xxx-xxxx)
    - `phoneSecondary` string: Teléfono 2 del contacto. (Formato si indentificación no es extranjera: xxx-xxx-xxxx)
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contactp con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
  - object
    - `name` string, required: Nombre del contacto.
    - `identificationObject` object: Identificación del contacto.
      - `number` string: Número de identificación (Obligatorio si el campo type tiene valor): * `DNI` - Documento Nacional de Identidad Formato: Longitud máxima 9 Caracteres * `NIF` - Número de Identificación Fiscal Formato: Longitud máxima 9 Caracteres * `NIF-IVA` - Número de Identificación Fiscal - IVA Formato: Longitud máxima 9 Caracteres * `PP` - Pasaporte Formato: Longitud máxima 20 Caracteres * `DPO` - Documento País de Origen Formato: Longitud máxima 20 Caracteres * `CR` - Certificado de Residencia Formato: Longitud máxima 20 Caracteres * `ODP` - Otro Documento Probatorio Formato: Longitud máxima 20 Caracteres * `NC` - No Censado Formato: Longitud máxima 20 Caracteres
      - `type` 'DNI' | 'NIF' | 'NIF-IVA' | 'PP' | 'DPO' | 'CR' | 'ODP' | 'NC': Tipo de identificación: * `DNI` - Documento Nacional de Identidad * `NIF` - Número de Identificación Fiscal * `NIF-IVA` - Número de Identificación Fiscal - IVA * `PP` - Pasaporte * `DPO` - Documento País de Origen * `CR` - Certificado de Residencia * `ODP` - Otro Documento Probatorio * `NC` - No Censado
    - `address` object: Dirección del contacto.
      - `province` string: Provincia (obligatorio si identificación equivale a NIF)
      - `city` string: Municipio (obligatorio si identificación equivale a NIF)
      - `address` string: Dirección (obligatorio si identificación equivale a NIF-IVA, PP, DPO, CR, ODP)
      - `zipCode` string: Código postal (obligatorio si identificación equivale a NIF, formato 5 dígitos numéricos)
      - `country` string: País (obligatorio si identificación equivale a NIF-IVA, PP, DPO, CR, ODP)
    - `phonePrimary` string: Teléfono del contacto.
    - `phoneSecondary` string: Teléfono 2 del contacto.
    - `mobile` string: Número celular del contacto.
    - `seller` string: Identificador del vendedor asociado al contacto.
    - `priceList` string: Identificador de la lista de precios asociada al contacto.
    - `term` string: Identificador del plazo de pago asociado al contacto.
    - `creditLimit` number: Límite de crédito del contacto.
    - `email` string: Email del contacto.
    - `type` union: Tipo de contacto (cliente o proveedor o ambos)
      - 'client' | 'provider'
      - string[]
    - `status` 'active' | 'inactive': Estado del contacto.
    - `fax` string: Fax del contacto.
    - `accounting` object: Cuentas contables: por pagar y por cobrar.
      - `debtToPay` string: Id de cuenta contable por pagar asociada al contacto
      - `accountReceivable` string: Id de cuenta contable por cobrar asociada al contacto
    - `internalContacts` object[], nullable: Personas asociadas al contacto.
      - `name` string, required: Nombre
      - `lastName` string: Apellidos
      - `email` string: Email de persona asociada.
      - `mobile` string: Número de celular.
      - `phone` string: Número de teléfono.
      - `sendNotifications` boolean: Booleano que indica si se le deben enviar las notificaciones
    - `ignoreRepeated` boolean: Indica si se debe ignorar si existe otro contacto con el mismo número de identificación
    - `statementAttached` 'yes' | 'no': Indica si se debe incluir estado de cuenta al contacto
    - `equivalenceSurcharge` boolean: Indica si el contacto aplica recargo de equivalencia (solo para España)

## Response `200`

Se crea el contacto exitosamente

- union
  - 0 (unresolved $ref)
  - 1 (unresolved $ref)
  - 2 (unresolved $ref)
  - 3 (unresolved $ref)
  - 4 (unresolved $ref)
  - 5 (unresolved $ref)
  - 6 (unresolved $ref)
  - 7 (unresolved $ref)
  - 8 (unresolved $ref)
  - 9 (unresolved $ref)
  - 11 (unresolved $ref)
  - 12 (unresolved $ref)
  - 13 (unresolved $ref)
  - 14 (unresolved $ref)
  - 15 (unresolved $ref)
  - 16 (unresolved $ref)
  - 17 (unresolved $ref)

## Other responses

- `400`: Request incorrecto

---

[API](https://skmtc.dev/alegra/apis/contactos.md) - [All operations](https://skmtc.dev/alegra/apis/contactos/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/contactos/revisions/f09813b39dea?raw)