Page Comparison

Panel

title	Estado

<

Status

colour	Green
title	En uso

>

Info

title	En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.

Este servicio será utilizado por CRM para consultar, actualizar o insertar distribuidores en BDC.

Situación actual

El identificador debe existir.

Descripción

Servicio para gestión de alta , modificación y actualización de entidad distribuidor.

Entidad BDC

persona / persona_rol

Tipo de Petición

POST / GET / PUT

Parámetros

Campos

en URL

	Descripción	Reglas de negocio

UUID del Distribuidor que se consulta

UUID del Distribuidor que se consulta
Obligatorio (en caso de GET o PUT)

refId

Va en blanco ya que se insertará un nuevo distribuidor.

type

Rol
Valor : Distributor

Obligatorio

En caso de ser un

ID de persona no válido o con borrado lógico

valor distinto entrega el siguiente mensaje:
<code>404</code>

<message>No se encontraron datos con los parámetros especificados

<message>El valor indicado no es permitido.</message>

CamposDescripciónReglas de negociorefId

businessId

Identificador único en la BDC

persona

empresa.

persona

empresa_id.

Obligatorio (En caso de GET y PUT)

Empresa ó empresas a la que pertenece el distribuidor.
Obligatorio
Valores: Id maestro empresa
active : true y false.
param: Parámetro maestro empresa

El identificador debe existir.

Para método GET, el identificador debe ser distribuidor.

En caso de ser un ID de

persona

empresa no válido

o con borrado lógico entrega

entrega el siguiente mensaje:
<code>404</code>
<message>No

existe la entidad con el id especificado.</message>type

Rol

Obligatorio

Debe ser distribuidor.

En caso de ser un rol distribuidor entrega el siguiente mensaje:

<code>404</code>
<message>No existe el rol especificado

se encontraron datos con los parámetros especificados.</message>
firstName	Nombre Obligatorio
middleName	Apellido paterno
lastName	Apellido materno
sex	Valores: Male, Female, Legal
language	Idioma Obligatorio Valores: Clave maestro idioma.	El identificador debe existir. En caso de ser una clave no válida entrega el siguiente mensaje: <code>404</code> <message>No existe

idioma especificado

la entidad con clave especificada.</message>

country

Municipio

País
Obligatorio
Valores: Clave maestro

municipio

país.

El identificador debe existir.
En caso de ser una clave no válida entrega el siguiente mensaje:
<code>404</code>
<message>No existe

municipio especificado

la entidad con clave especificada.</message>
timeZone	Zona Horaria Obligatorio Valores: Clave maestro zona_horaria	El identificador debe existir. En caso de ser una clave no válida entrega el siguiente mensaje: <code>404</code>

<message>No existe Zona Horaria especificado

<message>No existe la entidad con clave especificada.</message>
erpId
officialId	Número de identificación asignado por las autoridades fiscales en caso de México RFC.
taxId	Número de identificación asignado a cada empresa por las autoridades fiscales en caso de México RFC.
addressType	Tipo domicilio Valores: Physical, Mailing, Shipping
street line1	Calle
city	Ciudad
neighborhood	Colonia
postalCode	Código postal
buildingSiteNumber	Número

country


county	Identificador único en la BDC municipio.municipio_

id

clave

Obligatorio

Valores: Clave maestro municipio
stateProvince

Identificador único en la BDC municipio.estado_id

Obligatorio

Valores: Clave maestro estado

Estado
countyRefId	Identificador único en la BDC municipio.municipio_id Obligatorio Valores: Id maestro

zona_horaria

municipio	El identificador debe existir. En caso de ser un ID no válido entrega el siguiente mensaje: <code>404</code> <message>No existe la entidad con el id especificado.</message>
phoneNumberType	Tipo Valores: Home, Mobile
number	Teléfono
email	Correo Electrónico
website	Página Web del Distribuidor

Ejemplo de llamada o de formulario

https://homol.uno-internacional.com/wssb/crm/seller

Code Block

language	xml
title	Payload

<seller refId="">
	<type>Distributor</type>
    <name>
        <firstName>Distribuidora de libros Panamericana</firstName>
        <middleName></middleName>
        <lastName></lastName>
    </name>
    <sex>Legal</sex>
    <language>ES</language>
    <country>CO</country>
    <timeZone>CO.STD</timeZone>
    <erpId>ERP000898</erpId>
    <officialId></officialId>
    <taxId>MOCX850516XXX</taxId>
    <businessList>
        <business>
        	<businessId active="true" param="CO/COMP">00000000-0000-1000-0000-000000000010</businessId>
		</business>
    </businessList>
    <addressList>
        <address addressType="Physical">
            <street>
                <line1>CALLE 8 DE MAYO</line1>
            </street>
            <city>Colombia</city>
            <neighborhood>PLANETARIO LINDAVISTA</neighborhood>
            <postalCode>07300</postalCode>
            <buildingSiteNumber>2</buildingSiteNumber>
            <county>Margarita</county>
            <stateProvince>Bolívar</stateProvince>
            <countyRefId>00000000-0000-1000-0000-000000015434</countyRefId>
        </address>
        <address addressType="Mailing">
            <street>
                <line1>CALLE 8 DE MAYO</line1>
            </street>
            <city>Colombia</city>
            <neighborhood>PLANETARIO LINDAVISTA</neighborhood>
            <postalCode>07300</postalCode>
            <buildingSiteNumber>2</buildingSiteNumber>
            <county>Margarita</county>
            <stateProvince>Bolívar</stateProvince>
            <countyRefId>00000000-0000-1000-0000-000000015434</countyRefId>
        </address>
    </addressList>
    <phoneNumberList>
        <phoneNumber phoneNumberType="Home">
            <number>53956782</number>
        </phoneNumber>
        <phoneNumber phoneNumberType="Mobile">
            <number>5537651829</number>
        </phoneNumber>
    </phoneNumberList>
    <email>staff@seller.com</email>
    <website>www.seller.com</website>
</seller>

Respuesta

Code Block

language	xml
title	POST

<createResponse>
    <creates>
        <create id="00000000-0000-1000-0000-000006605389"  statusCode="200" ></create>
    </creates>
</createResponse>

Error

Code Block

language	xml

<error refId="00000000-0000-1000-0000-000000000000">
    <code>404</code>
    <message>No existe la entidad con clave especificada.</message>
</error>

¿Quién lo utiliza y cómo?

Es utilizado a través de integración CRM.

Version	Old Version 2	New Version Current
Changes made by	Tania Romo	Tania Romo
Saved on	Oct 22, 2018	Oct 26, 2018

Versions Compared

Key