Objeto «partner»

Este artículo trata sobre el objeto «partner» dentro del objeto «Document».

En la sección de descargas del sitio web de RetailForce (Documentación del modelo de objetos.pdf), dentro del directorio de la versión correspondiente, se puede encontrar una descripción completa del RetailForce DOM, así como una descripción de los elementos individuales.

El objeto «parter» almacena información sobre los socios comerciales de la empresa emisora del documento. Estos pueden ser socios externos, como clientes o proveedores, así como «clientes» internos, como una sucursal específica de la empresa a la que se envían las mercancías.

A continuación se muestra un objeto «partner» con datos de ejemplo.

"partner": {
  "id": "2241247",
  "caption": "Jane Doe",
  "isBusiness": true,
  "partnerType": "[0] = Customer",
  "partnerClassification": "Customer",
  "vatNumber": null,
  "taxNumber": null,
  "identificationType": "passport",
  "partnerIdentification": null,
  "additionalIdentifications": null,
  "addresses": [
    {
      "addressType": "[1] = BillingAddress,
      "street": "Hintere Zollamtsstraße",
      "streetNumber": "4",
      "postalCode": "1030",
      "city": "Wien",
      "community": null,
      "countryCode": "AUT"
    }
  ],
  "addressType": "[1] = BillingAddress,
  "street": "Hintere Zollamtsstraße",
  "streetNumber": "4",
  "postalCode": "1030",
  "city": "Wien",
  "community": null,
  "countryCode": "AUT"
},

El objeto «partner» contiene la siguiente información.

Información de la columna «Tipo»:

M ... obligatorio / requerido
M* ... obligatorio / requerido en determinados países o bajo determinadas condiciones
R ... recomendado
O... opcional

Elementos		Tipo	Descripción
ID		M	ID del socio. Puede ser, por ejemplo, el número de cliente o el ID.
caption		O	Denominación de los socios (p. ej., nombre, razón social).
IsBusiness		M*	Indica si la transacción se realiza entre empresas (true) o transacción B2B (true) o una transacción B2C (falso). Datos del país: Francia: Información obligatoria Portugal: Información obligatoria Québec/Canadá: Información obligatoria
PartnerType		M*	Tipo o clase de socio (empresarial) (Enum). Actualmente: [0] = Cliente [1] = Proveedor Datos del país: Portugal: Información obligatoria
PartnerClassification		O	Clasificación del interlocutor (¡no el PartnerType!).
VatNumber		M*	ID de VAT del socio (obligatorio para transacciones B2B).
taxNumber		O	Número fiscal del socio, p. ej., «NIF» (¡NO es el número de Vat!)
IdentificationType		M*	Forma en la que se ha verificado la identidad del socio. Enum PartnerIdentificationType: OfficialDocument Otro Pasaporte Certificado de residencia
PartnerIdentification		M*	Identificación de la pareja: si se establece, también debe establecerse la propiedad «IdentificationType».
AdditionalIdentifications		O	Características de identificación adicionales para diversos fines.
	lotteryId	O	ID de lotería personal de un cliente en Italia. Es obligatorio para participar en la denominada lotería diferida («Lotteria Differita») de la «Lotteria degli Scontrini» («Lotería de los tickets de compra»). Datos del país: Italia: Si un cliente desea participar en la «Lotteria Differita», debe introducir su ID personal en este campo.
	additionalProp1	O	Características adicionales del ID para diversos fines.
	additionalProp2	O	Características adicionales de ID para diversos fines.
	additionalProp3	O	Características adicionales de ID para diversos fines.
direcciones		O/M*	Permite introducir varias direcciones o direcciones adicionales. Si solo se va a proporcionar una dirección, utilice el campo general «Document.Partner». Nota: Por regla general, las direcciones deben figurar siempre en las facturas B2B («documentType»: «[1] = Factura»).
	addressType	O/M*	La propiedad «addressType» definida en este nivel especifica el tipo de dirección introducida en «Document.Partner.Addresses». Están disponibles los siguientes tipos de dirección: [1] = BillingAddress, [2] = Dirección de entrega, [3] = DirecciónResidencial, [4] = CompanyLocation, [5] = Servicio prestado Información sobre el país: Portugal: Especificación de los tipos de dirección para las facturas B2B en Portugal: [1] = BillingAddress - Obligatorio, [2] = DirecciónDeEntrega - Opcional
	calle	O/M*	Calle Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
	streetNumber	O/M*	Número de calle Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
	PostalCode	O/M*	Código postal Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses. El código postal debe estar en formato canadiense: A9A9A9 6 caracteres 1 carácter (letra), 1 dígito (número), 1 carácter (letra), 1 número, 1 carácter (letra), 1 número.
	ciudad	O/M*	Ciudad / Localidad Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
	comunidad	O	En ciertos países (por ejemplo, Eslovenia), el campo denominado «comunidad» forma parte de la dirección.
	CountryCode	O/M*	Código de país conforme a la norma ISO 3166 alfa-3 (3 dígitos). Datos del país: Portugal: Campo obligatorio
addressType		O/M*	La propiedad «addressType» definida en este nivel determina el tipo de dirección especificada en «Document.Partner». Si es necesario declarar múltiples direcciones con distintos tipos, puede realizarse en «Document.Partner.Addresses». Están disponibles los siguientes tipos de dirección: [1] = BillingAddress, [2] = DeliveryAddress, [3] = DirecciónResidencial, [4] = CompanyLocation, [5] = ServicioPrestado Datos del país: Portugal: Especificación de los tipos de dirección en las facturas B2B en Portugal: [1] = BillingAddress - Obligatorio, [2] = Dirección de entrega: opcional
calle		O/M*	Calle Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
streetNumber		O/M*	Número de calle Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
PostalCode		O/M*	Código postal Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses. El código postal debe estar en formato canadiense: A9A9A9 6 caracteres 1 carácter (letra), 1 dígito (número), 1 carácter (letra), 1 dígito, 1 carácter (letra), 1 número.
ciudad		O/M*	Ciudad / Localidad Datos del país: Portugal: Campo obligatorio Québec: Campo obligatorio si se especifica un «socio» (cliente). Revenu Québec solo admite información sobre clientes canadienses.
comunidad		O	En ciertos países (por ejemplo, Eslovenia), el campo denominado «comunidad» forma parte de la dirección.
CountryCode		O/M*	Código de país conforme a la norma ISO 3166 alfa-3 (3 dígitos). Datos del país: Portugal: Campo obligatorio

Este artículo ha sido traducido automáticamente.

objeto «partner»

Artículos relacionados