Este artículo trata sobre el objeto «partner» dentro del objeto «Document».
En la sección de descargas del RetailForce website (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 «partner» contiene información sobre los respectivos socios (comerciales) de la empresa emisora del documento. Estos pueden ser, por ejemplo, socios externos, como clientes o proveedores, pero también «clientes» internos, como una sucursal concreta de la empresa a la que se envían las mercancías.
objeto «partner»
El siguiente objeto «partner» contiene datos de ejemplo.
"partner": {
"id": "2241247",
"caption": "Jane Doe",
"isBusiness": true,
"partnerType": "[0] = Customer",
"partnerClassification": "Customer",
"vatNumber": null,
"taxNumber": null,
"companyIdentification": [
{
"type": "[12] = LocationIdentification",
"identification": "1234567890ABC"
}
],
"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 «socio» 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 tratarse, por ejemplo, del número de cliente o del ID. | |
| descripción | O/M* |
Denominación de los interlocutores (p. ej., nombre, razón social). Datos del país:
|
|
| IsBusiness | M* |
Indica si la transacción es una
Datos del país:
|
|
| PartnerType | M* |
Tipo o clase de socio (empresarial) (Enum). Actualmente:
Datos del país:
|
|
| PartnerClassification | O | Clasificación del socio (¡no el PartnerType!). | |
| VatNumber | M* |
ID de Vat del socio (puede ser necesario para determinadas transacciones B2B, en función de la normativa del Vat aplicable). Datos del país:
|
|
| taxNumber | O | Número de identificación fiscal del socio, p. ej., «número de identificación fiscal de la empresa» (¡NO el número de Vat!) | |
| companyIdentification | O |
Otros datos de identificación del cliente (B2B) para diversos fines. | |
| tipo | O |
Define el tipo de atributo de ID. Valores posibles:
Puede consultar la descripción técnica de cada uno de estos elementos en el artículo «Identificación de la empresa». Datos por país:
|
|
| identificación | O |
Define el valor real del atributo de ID (por ejemplo, el SIRET en Francia cuando se especifica el tipo [12] = LocationIdentification). | |
| IdentificationType | M* |
forma en la que se ha confirmado la identidad del interlocutor. Enum PartnerIdentificationType:
|
|
| 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:
|
|
| additionalProp1 | O | Características adicionales del ID para diversos fines. | |
| additionalProp2 | O | Características de identificación adicionales para diversos fines. | |
| additionalProp3 | O | Características adicionales de identificación 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:
Información sobre el país:
|
|
| calle | O/M* |
Calle Datos del país:
|
|
| streetNumber | O/M* |
Número de calle Datos del país:
|
|
| PostalCode | O/M* |
Código postal Datos del país:
|
|
| ciudad | O/M* |
Ciudad / Localidad Datos del país:
|
|
| comunidad | O |
En algunos 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:
|
|
| addressType | O/M* |
La propiedad «addressType» definida en este nivel determina el tipo de dirección introducida en «Document.Partner». Si necesita especificar varias direcciones diferentes con distintos tipos de dirección, puede hacerlo en «Document.Partner.Addresses». Están disponibles los siguientes tipos de dirección:
Datos del país:
|
|
| calle | O/M* |
Calle Datos del país:
|
|
| streetNumber | O/M* |
Número de calle Datos del país:
|
|
| PostalCode | O/M* |
Código postal Datos del país:
|
|
| ciudad | O/M* |
Ciudad / Localidad Datos del país:
|
|
| comunidad | O | En algunos países (por ejemplo, Eslovenia), la denominada «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:
|
|
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.