Servicio Articulo

Estado

<EN USO>

En Uso

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


Descripción general y propósito del servicio

Situación actual

DescripciónPermite dar de alta artículos y calsificarlo para ser usado en un grado específico
Referencia/wiki/spaces/SSB/pages/51904547
Entidad BDCarticulo , articulo_materia, articulo_grado_periodo, articulo_nivel_precio
Backendhttps://homol.uno-internacional.com/ws/uno_wsx_articulo_grado_periodo_precio_im.php
Tipo de Petición

POST / PUT

Parámetros
Campos en PayloadDescripciónReglas de negocio
accion
  • i  para indicar que se crea una entidad, m para modificar una entidad 
  • Obligatorio
  • Cuando se desea crear una entidad el valor de articulo_id debe ser 0.
  • Cuando se desea modificar una entidad de articulo, el valor de articulo_id debe ser mayor que 0.
p
  • IP de la máquina desde la que se consume el servicio
  • Obligatorio


t
  • Token de sesión
  • Obligatorio
  • El token de sesión se obtiene mediante el servicio de login
  • Tiene una duración de 8 horas
servicio
  • Nombre del servicio, se deberá enviar articulo
  • Obligatorio
  • Nombre del servicio a utilizar de acuerdo a WSDL Import
articulo_id
  • Identificador único del artículo en BDC
  • Obligatorio
  • El ID del artículo debe ser mayor a 0, en el caso de crear una entidad de Artículo el valor enviado deberá ser 0.
erp_id
  • Identificador único del colegio en ERP (EMS, SAP, ETC)
  • Opcional

pais_id
  • Identificador del país al que pertenece el artículo
  • Obligatorio
empresa_id
  • ID de la empresa a la que pertenece el artículo
  • Obligatorio
articulo_clave
  • Identificador único del artículo o el equivalente al erp_id
  • Obligatorio
  • La clave es utilizada para localizar de forma rápida al Artículo en búsquedas
articulo
  • Nombre del articulo
  • Obligatorio
articulo_orden
  • Orden de listado en los filtros
  • Opcional
  • Número > 0
articulo_grado_periodos
  • Agrupador de articulo_grado_periodos
Esta agrupación definirá la configuiración que tendrá el artículo por ciclo, periodo, nivel y grado, si se desea esta configuración se puede realizar por colegio
articulo_grado_periodo
  • Agrupador de articulo_grado_periodo

articulo_grado_periodo_id
  • Identificador único de articulo_grado_periodo_id
  • Obligatorio
  • Cuando se desea crear una nueva agrupación el valor  deberá ser 0
  • Cuando se modifica una agrupación el valor deberá ser > 0
grado_id
  • Identificador del grado al que estará asociado el artículo
  • Opcional
grado_clave
  • Clave del grado al que estará asociado el artículo
  • Obligatorio
grado_erp
  • Erp del grado al que estará asociado el artículo
  • Opcional
nivel_clave
  • Clave del nivel al que estará asociado el artículo
  • Obligatorio
nivel_erp
  • Erp del nivel al que estará asociado el artículo
  • Opcional
ciclo_escolar_id
  • Identificador del ciclo al que está asociado el Ciclo escolar.
  • Opcional
ciclo_escolar_clave
  • Clave del ciclo escolar al que estará asociado el artículo
  • Obligatorio
periodo_ciclo_id
  • Identificador del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Opcional
periodo_ciclo_clave
  • Clave del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Obligatorio
periodo_ciclo_parametro
  • Parámetro del periodo al que estará asociado el artículo, este periodo debe estar definido para el ciclo escolar indicado anteriormente.
  • Opcional (este campo se debe enviar si los datos periodo_ciclo_id  y periodo_ciclo_clave no fueron enviados)
activo
  • Determinará si la configuración debe estar activa.
  • Posibles valores 1 / 0
colegio_id
  • Identificador del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio.
  • El ID del colegio debe ser mayor a 0, asignado automáticamente por BDC.
colegio_clave
  • Clave del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio.

colegio_erp_id
  • Código de ERP asignado en BDC del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio y no se cuenta con los datos id y clave

colegio_crm_id
  • Código de CRM asignado en BDC del colegio al que se desea asignar la configuración.
  • Opcional, este dato será enviado sólo si se desea una configuración especifica para un colegio y no se cuenta con los datos id , clave y erp_id

articulo_nivel_precios
  • Agrupador de articulo_nivel_precios
Esta agrupación permite asignar el precio e impuesto al articulo según el PVP.
articulo_nivel_precio
  • Agrupador de articulo_nivel_precio

articulo_nivel_precio_id
  • Identificador del articulo_nivel_precio_id al que estará asociado el artículo
  • Opcional
  • Cuando se desea crear una entidad el valor de articulo_nivel_precio_id debe ser 0.
  • Cuando se desea modificar una entidad la tabla articulo_nivel_precio, el valor de articulo_nivel_precio_id debe ser mayor que 0.
nivel_precio_id
  • Identificador del nivel_precio al que estará asociado el artículo
  • Opcional ( será obligatorio si no se envía el tag nivel_precio_clave)
nivel_precio_clave
  • Clave del nivel_precio al que estará asociado el artículo.
  • Obligatorio
colegio_nivel_ciclo_id
  • Identificador del colegio_nivel_ciclo_id al que estará asociado el artículo
  • Opcional
  • El id se envía si el precio a configurar sólo aplicará a un nivel_ciclo  configurado en la agrupación por colegio.
colegio_grado_grupo_id
  • Identificador del colegio_grado_grupo_id al que estará asociado el artículo
  • Opcional
  • El id se envía si el precio a configurar sólo aplicará a un grado_grupo configurado en la agrupación por colegio.
precio
  • Precio con el que se configura el artículo
  • Obligatorio
  • Valor permitido Float
impuesto_porcentaje
  • Porcentanje que será usado en caso de que el artículo maneje un impuesto
  • Opcional
  • Valor permitido Float
Ejemplo de llamada o de formulario
Payload
Payload
<xs:schema id="articulo_grado_periodo_precio_im"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
attributeFormDefault="unqualified"
elementFormDefault="qualified">
<xs:element name="articulo_grado_periodo_precio_im">
<xs:complexType>
<xs:sequence>
<xs:element name="Articulo">
<xs:complexType>
<xs:sequence>
<xs:element type="xs:integer" name="articulo_id" minOccurs="0"/>
<xs:element type="xs:integer" name="empresa_id"/>
<xs:element type="xs:integer" name="pais_id"/>
<xs:element type="xs:string" name="articulo_clave"/>
<xs:element type="xs:string" name="articulo"/>
<xs:element type="xs:string" name="articulo_abrev" minOccurs="0"/>
<xs:element type="xs:string" name="articulo_alterno" minOccurs="0"/>
<xs:element type="xs:string" name="articulo_orden"/>
<xs:element type="xs:string" name="erp_id" minOccurs="0"/>
<xs:element type="xs:string" name="ean" minOccurs="0"/>
<xs:element type="xs:string" name="isbn" minOccurs="0"/>
<xs:element type="xs:string" name="ean_alterno" minOccurs="0"/>
<xs:element type="xs:string" name="materia_clave" minOccurs="0"/>
<xs:element type="xs:string" name="categoria_parametro"/>
<xs:element type="xs:string" name="tipo_articulo_parametro"/>
<xs:element type="xs:string" name="agrupa_articulo_parametro" minOccurs="0"/>
<xs:element type="xs:string" name="parametro"/>
<xs:element name="articulo_grado_periodos">
<xs:complexType>
<xs:sequence>
<xs:element name="articulo_grado_periodo" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
						<xs:element type="xs:string" name="articulo_grado_periodo_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="grado_id" minOccurs="0"/>
						<xs:element type="xs:string" name="grado_clave"/>
						<xs:element type="xs:string" name="grado_erp" minOccurs="0"/>
						<xs:element type="xs:string" name="nivel_clave"/>
						<xs:element type="xs:string" name="nivel_erp" minOccurs="0"/>
						<xs:element type="xs:integer" name="ciclo_escolar_id" minOccurs="0"/>
						<xs:element type="xs:string" name="ciclo_escolar_clave"/>
						<xs:element type="xs:integer" name="periodo_ciclo_id" minOccurs="0"/>
						<xs:element type="xs:string" name="periodo_ciclo_clave"/>
						<xs:element type="xs:string" name="periodo_ciclo_parametro" minOccurs="0"/>
						<xs:element type="xs:integer" name="activo"/>
						<xs:element type="xs:integer" name="colegio_id" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_clave" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_erp_id" minOccurs="0"/>
						<xs:element type="xs:string" name="colegio_crm_id" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="articulo_nivel_precios">
	<xs:complexType>
		<xs:sequence>
			<xs:element name="articulo_nivel_precio" minOccurs="0" maxOccurs="unbounded">
				<xs:complexType>
					<xs:sequence>
						<xs:element type="xs:integer" name="articulo_nivel_precio_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="nivel_precio_id" minOccurs="0"/>
						<xs:element type="xs:string" name="nivel_precio_clave"/>
						<xs:element type="xs:integer" name="colegio_nivel_ciclo_id" minOccurs="0"/>
						<xs:element type="xs:integer" name="colegio_grado_grupo_id" minOccurs="0"/>
						<xs:element type="xs:decimal" name="precio"/>
						<xs:element type="xs:decimal" name="impuesto_porcentaje" minOccurs="0"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
		</xs:sequence>
	</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Respuesta
Respuesta
<?xml version="1.0" encoding="utf-8"?>
<articulo_im_resultado xmlns="http://www.sistemauno.com/source/xml">
  <OK>
    <articulo_id>27466</articulo_id>
    <erp_id>SE BEC E 9 F2 18</erp_id>
    <empresa_id>7</empresa_id>
    <ok_text>Transacción exitosa: m</ok_text>
  </OK>
</articulo_im_resultado>