# Get Supplier

Get a specific supplier.

Endpoint: GET /api/v1/supplier/{id}
Version: 1.0

## Path parameters:

  - `id` (integer, required)

## Response 200 fields (application/json):

  - `id` (integer, required)
    Unique identifier of the entity
    Example: 1

  - `code` (integer)

  - `cif` (string)

  - `commercialName` (string)

  - `vat` (object)
    Customer VAT type information

  - `vat.code` (string, required)
    VAT type code. Example: GENERAL, REDUCED, EXEMPT, etc.
    Example: "GENERAL"

  - `vat.description` (string)
    Description of the VAT type.
    Example: "General VAT type"

  - `name` (string)

  - `address` (string)

  - `country` (object)

  - `country.code` (string, required)
    Country code (usually ISO numeric or similar).
    Example: 724

  - `country.description` (string, required)
    Country description or name.
    Example: "Spain"

  - `country.isoCode` (string)
    ISO Alpha-2 code for the country.
    Enum: "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"

  - `country.customerVatType` (string)
    Type of VAT scheme for customers in this country.
    Example: "GENERAL"

  - `country.geographicalLocation` (string, required)
    Geographical location of the country. See ApiGeographicalLocation enum for values.
    Enum: "CEUTA_MELILLA_CANARIAS", "COMMUNITY", "NATIONAL", "OTHERS"

  - `state` (object)

  - `state.description` (string)

  - `state.isoCode` (string)

  - `postalCode` (string)

  - `city` (string)

  - `phone1` (string)

  - `phone2` (string)

  - `replacementTime` (number)

  - `language` (object)

  - `language.code` (string, required)
    Language code.
    Example: "ES"

  - `language.description` (string, required)
    Description of the language.
    Example: "Spanish"

  - `language.isoCode` (string, required)
    ISO Alpha-2 language code enum.
    Enum: "AA", "AB", "AF", "AM", "AR", "AS", "AY", "AZ", "BA", "BE", "BG", "BH", "BI", "BN", "BO", "BR", "CA", "CO", "CS", "CY", "DA", "DE", "DZ", "EL", "EN", "EO", "ES", "ET", "EU", "FA", "FI", "FJ", "FO", "FR", "FY", "GA", "GD", "GL", "GN", "GU", "GV", "HA", "HE", "HI", "HR", "HU", "HY", "IA", "ID", "IE", "IK", "IS", "IT", "IU", "JA", "JW", "KA", "KK", "KL", "KM", "KN", "KO", "KS", "KU", "KW", "KY", "LA", "LB", "LN", "LO", "LT", "LV", "MG", "MI", "MK", "ML", "MN", "MO", "MR", "MS", "MT", "MY", "NA", "NE", "NL", "NO", "OC", "OM", "OR", "PA", "PL", "PS", "PT", "QU", "RM", "RN", "RO", "RU", "RW", "SA", "SD", "SE", "SG", "SH", "SI", "SK", "SL", "SM", "SN", "SO", "SQ", "SR", "SS", "ST", "SU", "SV", "SW", "TA", "TE", "TG", "TH", "TI", "TK", "TL", "TN", "TO", "TR", "TS", "TT", "TW", "UG", "UK", "UR", "UZ", "VI", "VO", "WO", "XH", "YI", "YO", "ZA", "ZH", "ZU"

  - `currency` (object)
    Currency information

  - `currency.nomenclature` (string)

  - `currency.isoCode` (string)
    Defines the ISO currency codes.
    Enum: "AED", "AFA", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZM", "BAM", "BBD", "BDT", "BGL", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CYP", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GGP", "GHC", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGF", "MKD", "MMK", "MNT", "MOP", "MRO", "MTL", "MUR", "MVR", "MWK", "MXN", "MYR", "MZM", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "ROL", "RUR", "RWF", "SAR", "SBD", "SCR", "SDD", "SEK", "SGD", "SHP", "SIT", "SKK", "SLL", "SOS", "SPL", "SRG", "STD", "SVC", "SYP", "SZL", "THB", "TJS", "TMM", "TND", "TOP", "TRL", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEB", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "YER", "YUM", "ZAR", "ZMK", "ZWD", "RUB", "TRY"

  - `currency.changeValue` (number)

  - `currency.significantDecimalsDocuments` (integer)

  - `currency.intermediateDecimalsDocuments` (integer)

  - `currency.decimalsCalculatePrices` (integer)

  - `currency.decimalsCalculateCosts` (integer)

  - `manufacturer` (boolean)

  - `importer` (boolean)

  - `active` (boolean)

  - `notCreateOrder` (boolean)

  - `observation` (string)

  - `geographicalLocation` (string)
    Defines the geographical locations.
    Enum: "CEUTA_MELILLA_CANARIAS", "COMMUNITY", "NATIONAL", "OTHERS"

  - `creationDate` (string)

  - `inactiveDate` (string)

  - `accountingAccount` (object)
    Surcharge account information for purchase operations

  - `accountingAccount.code` (string)
    Code of the chart account
    Example: 1000

  - `accountingAccount.description` (string)
    Description of the chart account
    Example: "Cash account"

  - `accountingAccount.cif` (string)
    Tax identification number
    Example: "B12345678"

  - `accountingAccount.active` (boolean)
    Indicates if the account is active
    Example: true

  - `accountingAccount.color` (string)
    Color code for visual representation
    Example: "#FF5733"

  - `accountingAccount.parentCode` (string)
    Code of the parent account
    Example: 100

  - `accountingAccount.parentDescription` (string)
    Description of the parent account
    Example: "Assets"

  - `customer` (object)

  - `customer.id` (integer, required)
    Customer unique identifier.
    Example: 10001

  - `customer.code` (integer, required)
    Customer numeric code.
    Example: 10001

  - `customer.name` (string)
    Legal name of the customer.
    Example: "Acme S.A."

  - `customer.commercialName` (string, required)
    Commercial name of the customer.
    Example: "Acme España"

  - `customer.cif` (string)
    Tax identification code (CIF/NIF).
    Example: "B12345678"

  - `customer.address` (string)
    Postal address of the customer.
    Example: "Av. de la Estación, 5"

  - `customer.firstPhoneNumber` (string)
    First phone number.
    Example: "+34600111222"

  - `customer.secondPhoneNumber` (string)
    Second phone number.
    Example: "+34600333444"

  - `customer.postalCode` (string)
    Postal code.
    Example: "03001"

  - `customer.countryDescription` (string, required)
    Country name or description.
    Example: "Spain"

  - `customer.stateDescription` (string)
    State name or description.
    Example: "Alicante"

  - `customer.email` (string)
    Email address.
    Example: "info@acme.es"

  - `customer.city` (string, required)
    City name.
    Example: "Alicante"

  - `customer.activity` (string)
    Activity description.
    Example: "Wholesale Trade"

  - `customer.brand` (string)
    Brand description.
    Example: "Acme"

  - `customer.brandId` (integer)
    Brand identifier.
    Example: 100

  - `customer.creationDate` (string, required)
    Date of customer creation. Format: yyyy-MM-dd
    Example: "2020-01-01"

  - `customer.isActive` (boolean)
    True if the customer is active.
    Example: true

  - `customer.inactiveDate` (string)
    Date when customer became inactive. Format: yyyy-MM-dd
    Example: "2023-08-07"

  - `customer.paymentMethodId` (integer)
    Payment method identifier.
    Example: 1

  - `customer.paymentMethod` (string)
    Payment method description.
    Example: "Bank Transfer"

  - `customer.paymentMethodServeFullPrePaid` (boolean)
    If true, payment method requires all amount prepaid.

  - `customer.rateCode` (string)
    Rate code used for customer.
    Example: "RATE-001"

  - `customer.account` (string)
    Bank account number.
    Example: "ES9820385778983000760236"

  - `customer.vatDescription` (string)
    Tax regime description (VAT).
    Example: "General"

  - `customer.discount1` (number)
    First discount rate (percent).
    Example: 5

  - `customer.currencyCode` (string)
    Currency code.
    Example: "EUR"

  - `customer.currencyDescription` (string)
    Currency description.
    Example: "Euro"

  - `customer.modifiedOn` (string)
    When information was last updated. Format: yyyy-MM-dd'T'HH:mm:ss
    Example: "2024-08-07T12:30:00"

  - `customer.bankName` (string)
    Name of the customer's bank.
    Example: "Santander"

  - `customer.contactPerson` (string)
    Main contact person.
    Example: "Juan Pérez"

  - `customer.web` (string)
    Web URL.
    Example: "https://www.acme.es"

  - `customer.picture` (string)
    Picture or logo (URL or base64).
    Example: "https://www.acme.es/logo.png"

  - `customer.pictureToken` (string)
    Authentication token for the picture file.
    Example: "xyz-token-241235"

  - `customer.tags` (array)
    List of assigned customer tags.
    Example: ["VIP","EXPORT"]

  - `operator` (object)

  - `warehouse` (object)
    Warehouse information

  - `warehouse.code` (string, required)
    Warehouse code (unique per warehouse).
    Example: "ALM01"

  - `warehouse.description` (string, required)
    Warehouse description.
    Example: "Central warehouse"

  - `email` (string)

  - `paymentMethod` (object)
    DTO para listar los métodos de pago disponibles

  - `paymentMethod.code` (integer, required)
    Código único del método de pago
    Example: 1

  - `paymentMethod.description` (string, required)
    Descripción del método de pago
    Example: "Transferencia bancaria"

  - `paymentMethod.document` (string)
    Documento asociado al método de pago
    Example: "Contrato"

  - `paymentMethod.firstTerm` (integer)
    Primer plazo de pago en días
    Example: 30

  - `paymentMethod.terms` (integer)
    Número total de plazos
    Example: 3

  - `paymentMethod.daysTerms` (integer)
    Días entre plazos
    Example: 30

  - `paymentMethod.remittance` (boolean)
    Indica si es una remesa
    Example: true

  - `paymentMethod.addToCustomerBase` (boolean)
    Indica si se debe añadir a la base de clientes
    Example: true

  - `paymentMethod.serveFullPrePaid` (boolean)
    Indica si sirve como pago anticipado completo

  - `paymentMethod.observations` (string)
    Observaciones adicionales
    Example: "Requiere verificación bancaria"

  - `paymentMethod.icon` (string)
    Icono representativo del método de pago
    Example: "fa-credit-card"

  - `paymentMethod.facturaECode` (string)
    Código de factura electrónica asociado
    Enum: "NOT_SPECIFIED", "CASH", "DOMICILED_RECEIPT", "RECEIPT", "TRANSFER", "ACCEPTED_LETTER", "LETTER_OF_CREDIT", "CONTRACT_AWARD", "BILL_OF_EXCHANGE", "PROMISORY_NOTE_IN_ORDER", "PROMISORY_NOTE_NOT_IN_ORDER", "CHECK_NOTE", "REPLACEMENT", "SPECIALS", "COMPENSATION", "POSTAL_ORDER", "FORMED_CHECK", "BANK_CHECK", "CASH_ON_DELIVERY_PAYMENT", "PAYMENT_BY_CARD"

  - `terms` (integer)

  - `daysFirstTerm` (integer)

  - `daysBetweenTerms` (integer)

  - `discount1` (number)

  - `discount2` (number)

  - `discountPp` (number)

  - `proximityType` (string)
    Defines the proximity types.
    Enum: "NEARBY", "PREVIOUS", "LATER"

  - `paymentDay1` (integer)

  - `paymentDay2` (integer)

  - `paymentDay3` (integer)

  - `weekday` (string)
    Enum: "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"

  - `paymentMethodObservation` (object)

  - `paymentMethodObservation.type` (string, required)
    Defines the observation types.
    Enum: "CLASSIFICATION", "PAYMENT_METHODS", "SHIPMENT", "PRODUCTION", "ORDERS", "BILLING", "DELIVERY_NOTE", "PACKING"

  - `paymentMethodObservation.blockOrder` (boolean)

  - `paymentMethodObservationDescription` (string)

  - `account` (string)

  - `swift` (string)

  - `bic` (string)

  - `agency` (object)

  - `agency.code` (string, required)
    Agency code.
    Example: "AG001"

  - `agency.name` (string, required)
    Name of the agency.
    Example: "Fast Transport Agency"

  - `shippingTerm` (object)
    Shipping terms information

  - `shippingTerm.customerPays` (boolean)

  - `shippingTerm.intrastatCode` (string)

  - `ropoCode` (string)

  - `ropoExpireDate` (string)

  - `tags` (array)

  - `irpfType` (string)
    Defines the IRPF types.
    Enum: "LEASES", "PROFESIONAL_ACTIVITIES", "AGRO"

  - `bankName` (string)

  - `contactPerson` (string)

  - `picture` (string)

  - `pictureToken` (string)

  - `incomeTaxRate` (number)

  - `web` (string)

  - `modifiedOn` (string)

  - `observations` (array)

  - `observations.title` (string, required)

  - `files` (array)

  - `files.token` (string, required)
    File token (unique identifier).
    Example: "729eda1d03b34634b8e3c81a8b2d0974"

  - `files.url` (string, required)
    URL to access or download the file.
    Example: "https://apihost.com/file/729eda1d03b34634b8e3c81a8b2d0974"

  - `files.fileName` (string, required)
    File name (with extension).
    Example: "invoice_2023.pdf"

  - `files.fileExtension` (string, required)
    File extension.
    Example: "pdf"

  - `files.fileSize` (integer)
    File size in bytes.
    Example: 1048576

  - `files.modifiedOn` (string, required)
    Date and time the file was last modified (ISO8601).
    Example: "2024-08-07T18:10:55"