TEF AR - Interface Agreement Phase 1 v2.0

TelefonicaArgentina
SRS Appendix - Interface Agreement
Apndice del SRS - Acuerdo de

Interfaces
Client:
Product:
CreatedBy:
FileName:
TelefonicaArgentina
TOAdirect4.5+
FelipePoncet
TEFARInterfaceAgreementPhase1.pdf
InterfaceAgreement
TOA TECHNOLOGIES, INC
TelefonicaArgentina
DocumentReleaseNotes/NotasdeVersionadodelDocumento
Date
Fecha
Revisedby
Revisadopor
12/11/2014
11/Dec/2014
FelipePoncet
ChangeDescription
DescripcinCambio
Changesfromphase0:
Documentedhowtocreatelinksbetweenactivities
XMLpropertiessectionupdatedwithchanges
propertiesthatneedtobeusedincapacityqueryupdated
Version
Versin
1.0
Cambiosconrespectoafase0:
Sedocumentacomocrearlosvnculosentreactividades
SeactualizaconcambioslasecciondepropiedadesXML
Actualizadaslaspropiedadesquenecesitanserusadasen
laconsultadecapaciadad.
12/12/2014
12/Dec/2014
DeletedXA_ACCESS_DATAXMLproperty
XA_FO_DATAXMLpropertychanged
XA_ISP_DATAisnolongeraXMLproperty
BorradalapropiedadXMLXA_ACCESS_DATA
CambiadalapropiedadXMLXA_FO_DATA
XA_ISP_DATAdejadeserpropiedadXML
2.0
DistributionList/ListadeDistribucin
From:
FelipePoncet,<felipe.poncet@toatech.com>
To:TelefonicaArgentina
AndrsContona<andres.contona@telefonica.com>,
DanielLacherra<daniel.lacherra@telefonica.com>,
FernandoFeiertag<fernando.feiertag@telefonica.com>,
CorinaJuda<corina.juda@telefonica.com>,
AndrsScialpi<andres.scialpi@telefonica.com>
To:TelefnicaGlobalCTO
SantiagoGonzlez<santiago.gonzalezcelis@telefonica.com>,
JessIglesias<jesus.iglesiasmaqeuda@telefonica.com>
CC:TOA/Oracle
ThelmaCassapula<thelma.cassapula@oracle.com>,
BorjaTorn<borja.toron@oracle.com>
CC:Indra
JavierLlobet<jllobetl@indra.es>,
SoledadCarretero<spcarretero@indracompany.com>
InterfaceAgreement
TelefonicaArgentina
1.Introduction/Introduccin
PurposeofDocument/PropositodelDocumento
RelatedDocuments/DocumentosRelacionados
2.TOAdirectInterfaces/InterfacesdeTOAdirect
Connectionparameters/ParmetrosdeConexin
InboundAPI/APIInbound
OutboundAPI/APIOutbound
CapacityAPI/APICapacity
ActivityV2API/APIActivityV2
APILOAD/CargadelaAPI
InboundAPI/APIInbound
OutboundAPI/APIOutbound
CapacityAPI/APICapacity
ActivityV2API/APIActivityV2
OverviewofInterfaces/ResumendeInterfaces
Datawarehouse
3.CapacityManagementInterfaces/InterfacesdeGestindeCapacidad
QueryCapacity/ConsultadeCapacidad
Scope
Alcance
InterfaceProtocol
RequestStructure/EstructuradelaPeticin
ResponseStructure/EstructuradelaRespuesta
4.InboundInterfaces/InterfacesInbound
4.1CreateWorkOrder/CrearOrdendeTrabajo
Scope
InterfaceProtocol
MessageFlow
4.2ModifyWorkOrder/ModificarOrdendeTrabajo
InterfaceProtocol
MessageFlow
4.3CancelWorkOrder/CancelacinOrdendeTrabajo
MessageFlow
5.OutboundInterfaces/InterfacesOutbound
5.1OutgoingMessageStructure/EstructuradelMensajedeSalida
5.2OutgoingMessageResponseStructure/EstructuradeRespuestaalMensajedeSalida
5.3StatusChange/CambiodeEstado
MessageFlow
FlujodeMensajes
CondificacinXML
6.1GetWorkOrders/ObtenerrdenesdeTrabajo
6.Approvals/Aprobaciones
InterfaceAgreement
TelefonicaArgentina
TelefnicaArgentina
TOATechnologies/Indra
7.CertificationTestPlan/PlandePruebasdeCertificacin
Schedule
InboundAPIcertification/CertificacindeAPIInbound
Table1:AcceptanceTesting
Table2:PerformanceTesting
CapacityAPIcertification
OutboundAPIcertification/CertificacindeAPIOutbound
A1.PropertiesDetails/DetalledePropiedades
A1.1CapacityQueryProperties/PropiedadesdelaConsultadeCapacidad
A1.2TimeSlotIdentifiers/IdentificadoresdelosTimeslots
A1.3InboundXMLProperties/PropiedadesXMLdeInbound
A1.4QuadrantCalculationMethod/MtododeClculodelCuadrante
A1.5EffortCode/CdigodeEsfuerzo
A2.MessagesExamples/MensajesdeEjemplo
A2.1CapacityQuery/ConsultadeCapacidad
A2.1.1CapacityQueryRequest/SolicituddeConsultadeCapacidad
A2.1.2CapacityQueryResponse/RespuestaalaConsultadeCapacidad
A2.2CreateOrder/CreacindeOrden
A2.2.1CreateOrderRequest/SolicituddeCreacindeOrden
A2.2.2ActivityCreationResponse/RespuestaalaCreacindeActividad
A2.3OrderModify/ModificacindeOrden
A2.3.1OrderModifyRequest/SolicituddeModificacindeOrden
A2.3.2OrderModifyResponse/RespuestadeModificacindeOrden
A2.4WorkOrderCancel/CancelacindeOrdendeTrabajo
A2.4.1WorkOrderCancelRequest/SolicituddeCancelacindeOrdendeTrabajo
A2.4.2WorkOrderCancelResponse/RespuestaalaCancelacindeOrdendeTrabajo
A2.5OutboundMessages/MensajesdeOutbound
A2.5.1StatusChange/CambiodeEstado
A2.5.2StatusChangeResponse/RespuestadeOutbound
A2.6ActivityMessages/MensajesdeActivity
A2.6.1GetActivitiesRequest/SolicituddeBsquedadeActividades
A2.6.2GetActivitiesResponse/RespuestadeBsquedadeActividades
InterfaceAgreement
TelefonicaArgentina
1. Introduction / Introduccin
Purpose of Document / Proposito del Documento
This document presents the Interface Agreement

for the Telefonica Argentinaprojectbased onthe
Target Architecture section of the Business
Requirement Specification (BRS) describing a
high level architecture.Interfacescovered insuch
document areonlythose related to the TOAdirect
product.
The followingis anarchitecturediagram, whereit
is assumed thatcommunicationswithTOA willbe
throughaMiddleware(orESB).
Este documento presenta el Acuerdo de uso de

Interfaces para el proyecto de Telefnica Argentina
basado en la seccin del documento BRS en la
seccin del Objetivo de Arquitectura. Lasinterfaces
cubiertasen estedocumento son slorelacionadas
alproductoTOAdirect.
A continuacin un diagrama dearquitectura, donde
seasumequelascomunicacionesconTOAserna
travsdeunMiddleware(ounESB)
InterfaceAgreement
TelefonicaArgentina
Related Documents / Documentos Relacionados

The following references were used in the
creationoftheInterfaceAgreement:
La siguiente seccin contiene referencias usadas

enlacreacindelInterfaceAgreement:
Ref
Document/Documento
TelefonicaArgentinaBRS
Description/Descripcin
Telefonica
Generic
Specification
Business
Requirements
Especificacin de RequisitosdeNegocioGenricopara
Telefonica
2
ETAdirect4.5_InboundInterface_SDK.pdf
TOAdirectInboundAPImessagesdescription.
Descripcin de los mensajes de la API Inbound de
TOAdirect
ETAdirect4.5_OutboundInterface_SDK.pdf
TOAdirectOutboundAPImessagesdescription.
Descripcin de los mensajes de la API Outbound de
TOAdirect
ETAdirect4.5_Capacity_SDK
TOAdirectCapacityAPImessagesdescription.
Descripcin de los mensajes de la API Capacity de
TOAdirect
TEFARDataStructures.xslx
DataModel
ModelodeDatos
ETAdirect4.5_ActivityManagement_SDK
TOAdirectActivityAPImessagesdescription.
Descripcin de los mensajes de la API Activity de
TOAdirect
InterfaceAgreement
TelefonicaArgentina
2. TOAdirect Interfaces / Interfaces de TOAdirect
Module
Mdulo
Required?
Requerido?
Notes
Notas
HTMLBrowserApplication
WAP/XHTMLMobileApplication
Mobileapp
Inventory
Contractors
DWH
VoiceMessages
EmailMessages
SMSMessages
SchedulingEngine
IncomingInterface(ICOMSGDIDownstream)
IncomingInterface
OutgoingInterface
GoogleMaps(tgeo)
Selfcareinterface(i.e.SOAP)
Routing
GPS
GPSman
CapacityProxy
Community
SOAP:
Selfcare
Inbound
Outbound
Capacity
Activity
Mobile
Resourcemanagement
InterfaceAgreement
TelefonicaArgentina
Connection parameters/ Parmetros de Conexin
Thefollowingconnectionparametersshouldbeused
fortheinterfacesdescribedinthisdocumentunless
otherspecified.
Lossiguientesparmetrosdeconexindeberanser
usadasparalasinterfacesdescritaseneste
documentoamenosqueseespecifiquelocontrario.
Inbound API / API Inbound

Parameter/Parmetro
Value/Valor
DefinitionURL(test)
https://telefonicaar.test.toadirect.com/soap/inbound/?wsdl
DefinitionURL(prod)
https://telefonicaar.toadirect.com/soap/inbound/?wsdl
Encoding
UTF8
Outbound API / API Outbound
Parameter/Parmetro
Value/Valor
Host(IPaddressorname)(dev)
<TBD>
Host(IPaddressorname)(test)
<TBD>
Host(IPaddressorname)(prod)
<TBD>
HTTPS(SSL)
<TBD>
Port
<TBD>
URL
<TBD>
Authenticationrequired
<TBD>
send_message_soap_action
<TBD>
drop_message_soap_action
<TBD>
get_message_status_soap_action
<TBD>
Encoding
UTF8
URL para respuestas asncronas

haciaTOA(TEST)
https://telefonicaar.test.toadirect.com/soap/outbound/?wsdl
URL para respuestas asncronas

haciaTOA(PROD)
https://telefonicaar.toadirect.com/soap/outbound/?wsdl
InterfaceAgreement
TelefonicaArgentina
Capacity API / API Capacity

Parameter/Parmetro
Value/Valor
DefinitionURL(test)
https://telefonicaar.test.toadirect.com/soap/capacity/?wsdl
DefinitionURL(prod)
https://telefonicaar.toadirect.com/soap/capacity/?wsdl
Encoding
UTF8
ActivityV2 API / API ActivityV2

Parameter/Parmetro
Value/Valor
DefinitionURL(test)
https://telefonicaar.test.toadirect.com/soap/activity/v2/?wsdl
DefinitionURL(prod)
https://telefonicaar.toadirect.com/soap/activity/v2/?wsdl
Encoding
UTF8
InterfaceAgreement
TelefonicaArgentina
API LOAD / Carga de la API

Inbound API/ API Inbound
Value
Valor
Parameter
Parmetro
Comments
Comentarios
MaximalquantityofWOspertimeinterval
Nmeromximoderdenesdetrabajopor
intervalo
25000perday/
pordia
Itreferstoamaximalquantityofworkordersina
timeinterval.
PeakquantityofWOspertimeinterval
Cantidadpicoderdenesdetrabajopor
intervalodetiempo(minutos)
100perminute/
porminuto
AveragequantityofupdatesperWO
Cantidadpromediodeactualizacionespor
ordendetrabajo.
Averageofupdatesperworkorder.
Promediodeactualizacionesdeunaorden
ClientSystemrequesttimetogenerateand
sendsinglerequestwithsinglecommand
inside.
Tiempoesperadoporelsistemadelcliente
parageneraryenviaruncomando(request)
individual.
210seconds/
segundos
Therewillnotbe
multiple
commands/No
habrcomandos
mltiples
Serefierealamximacantidadderdenesenun
intervalodetiempo
sendsinglerequestwithmultiplecommands
inside.
parageneraryenviaruncomando(request)
multiple.
sendpeakquantityofrequestswithsingle
commandinside.
parageneraryenviarunacantidadpeakde
comandos(request)individuales.
sendpeakquantityofrequestswithmultiple
commandsinside.
parageneraryenviarunacantidadpeakde
comandos(request)mltiples.
20seconds/
segundos
Quantityofcommandsinrequest
Cantidaddecomandosporrequerimiento.
Outbound API / API Outbound
Parameter
Parmetro
InterfaceAgreement
Value
Valor
Comments
Comentarios
10
TelefonicaArgentina
Maximalquantityofrequestsper <TBD>per
day
timeinterval
Cantidadmximadepeticionespor
intervalodetiempo(dia).
Peakquantityofrequestspertime <TBD>
interval
Cantidadpeakderequerimientos
porintervalodetiempo(minutos).
<TBD>
ClientSystemresponsetimetoa <TBD>
peakquantityofrequests.
Tiempoderespuestadelsistema
delclienteaunpeakderequisitos.
<TBD>
ClientSystemresponsetimetoa
singlerequest.
Tiempoderespuestadelsistema
delclienteaunrequisito
individual.
Quantityofcommandsinrequest
Cantidaddecomandospor
requerimiento.
Capacity API / API Capacity
CapacityAPIwillbeusedtoobtainquotaandavailable
capacity.
LaAPICapacityserusadaparaobtenerlacuota
ycapacidaddisponibe.
Parameter
Parmetro
Value
Valor
Comments
Comentarios
Maximalquantityofrequestspertimeinterval(day)
Cantidadmximaderequerimientosporintervalodetiempo(dia).
25000
Peakquantityofrequestspertimeinterval(minutes)
Cantidadpeakderequerimientosporintervalodetiempo(minutos).
100
ActivityV2 API / API ActivityV2
ActivityAPIwillbeusedtorequestthedetails(fields
andpropertyvalues)ofasingleactivity.
LaAPIActivityseutilizarparasolicitarlos
detalles(camposyvaloresdepropiedades)de
unaactividadindividual.
Parameter
Parmetro
Value
Valor
Comments
Comentarios
Maximalquantityofrequestspertimeinterval(day)
Cantidadmximaderequerimientosporintervalodetiempo(dia).
16
InterfaceAgreement
11
TelefonicaArgentina
Peakquantityofrequestspertimeinterval(minutes)
Cantidadpeakderequerimientosporintervalodetiempo(minutos).
InterfaceAgreement
12
TelefonicaArgentina
Overview of Interfaces/ Resumen de Interfaces
The following interactions have been identified during

scoping and requirementgathering sessions. Eachone
oftheseinteractionsis mappedtoanexistingfunctionin
TOAdirectSDKset:
Lassiguientesinteraccioneshansidoidentificadas
durantelassesionesdelevantamiento.Cadauno
deestasinteraccionesestnmapeadasauna
funcinexistenteenelsetdeSDKdeTOAdirect.
ID
Name
SDK
Function
Description
ID
Nombre
SDK
Funcin
Descripcin
INT_CAPACITY
QueryCapacity
Capacity
get_capacity
Getavailable
capacity
Consultarla
capacidad
disponible
Inbound
inbound_interface
Createanew
workorder
Crearunanueva
ordendetrabajo
Inbound
inbound_interface
Updatethe
propertiesofan
existingwork
order
Actualizarlas
propiedadesde
unaordende
trabajoexistente
Inbound
inbound_interface
Cancelsa
pendingorder
Cancelauna
ordenenestado
pendiente
Outbound
send_message
Notifiesachange
intheorder
status
Notificaun
cambioenel
estadodela
orden
ActivityV2
get_activities
Retrieveactivity
propertiesforthe
specifiedactivity
Obtenerlas
propiedadesde
unaactividad
especfica
ConsultadeCapacidad
INT_CREATE
CreateWorkOrder
CrearOrdendeTrabajo
INT_MODIFY
ModifyWorkOrder
ModificarOrdendeTrabajo
INT_CANCEL
CancelWorkOrder
CancelarOrdendeTrabajo
INT_SYNC
SynchronizeWorkOrder
SincronizarOrdendetrabajo
INT_QUERY
QueryActivitiesDetails
ConsultarDetallesdelas
Actividades
TOAdirect SDK documentation defines the security,

technical and functional requirements, format and
protocol required for each oneoftheseinteractions.
During Technical Design phase an Interface
Agreement document will be prepared by TOA in
InterfaceAgreement
La documentacin de SDK de TOAdirect define la

seguridad, requerimientos tcnicos y funcionales,
formatos y protocolos requeridos en cada una de
estas interacciones. Durante la fase de diseo
tcnico un documento de Acuerdo de uso de
13
TelefonicaArgentina
order to detail the technical specification of the

interface.
Interfaces ser preparado por TOA para detallarlas

especificacionestcnicasdelainterfaz.
Datawarehouse
Data warehouse files will be generated every night
andmadeavailable toTelefonicaArgentinaonanFTP
location. Time of extraction and location will be
specifiedontheSRS.
Losarchivos dedata warehousesegenerarntodas

las noches y se dispondrn a Telefonica Argentina
en una ubicacin FTP. La hora de extraccin y
ubicacinsernespecificadasenelSRS.
InterfaceAgreement
14
TelefonicaArgentina
3. Capacity Management Interfaces / Interfaces de Gestin de

Capacidad
Query Capacity / Consulta de Capacidad
Scope
Alcance
Query the Capacity Categories from TOAdirect in

order to evaluate if quota is still availablefor such
timeslot.
Permite consultar las categoras de capacidad

desde TOAdirect para evaluar si existe Cuota
disponibleparacadatimeslot.
Capacity query returns the bucket in which the

ordermust becreated,andthereforeitis mandatory
to execute the capacity query for all order types,
regardless of the existence of anappointment ora
definedSLA.
La consultadecapacidad devuelveelbucketen el
que debe crearse la orden de trabajo, y por lo
tanto es obligatorio realizar la consulta de
capacidad para todos los tipos de rdenes,
independientementedesilaordentieneunacitao
unSLAdefinido.
InterfaceProtocol
ProtocolodelInterfaz
INT_CAPACITYinterfaceisSOAPoverhttp.
INT_CAPACITY es un interfaz de tipo SOAP

sobrehttp.
Request Structure / Estructura de la Peticin

Requestsforget_capacitycommandwillincludethe
followingfieldsandstructures:
<user>structureasspecifiedinSDK
date: one or more <date> structures, as
specifiedinSDK
determine_location_by_work_zone:true
calculate_duration:true
calculate_travel_time:true
calculate_work_skills:true
<activity_field>structures:label/valuefields
asspecifiedintheSDKincludingvaluesfor
thefieldscontainedintheA1.1appendix.
Las peticiones delcomando get_capacity incluirn

lossiguientescamposyestructuras:
estructura<user> tal y comoseespecifica
enelSDK
date:una omsestructuras<date>,como
seespecificaenelSDK
determine_location_by_work_zone:true
calculate_duration:true
calculate_travel_time:true
calculate_work_skills:true
estructuras
<activity_field>: campos
label/value comoseespecifica enelSDK,
incluyendo valores para los campos
indicadosenelanexoA1.1
Response Structure / Estructura de la Respuesta

Responses for get_capacity command will include
thefollowinginformation:
activity_duration:
estimated
activity
duration,asspecifiedintheSDK
activity_travel_time: estimated travel time,
asspecifiedintheSDK
foreachdateincludedintherequest:
one or more <capacity> structure
for each timeslotcapacitycategory
that matches the skills andwhose
quota is set, with quota and
available
capacity in
that
timeslotcapacity category. It will
also include the bucket identifier,
InterfaceAgreement
Lasrespuestasdelaoperacinget_capacity
incluirnlasiguienteinformacin:
activity_duration: duracin estimada de la
actividad,comoseespecificaenelSDK
activity_travel_time: tiempo de viaje
estimado de la actividad, como se
especificaenelSDK
paracadafechaincludaenlapeticin:
una
o varias estructuras
<capacity>
para
cada
combinacinde timeslotcategora
de capacidadquecoincidaconlos
skills indicados y cuya cuota se
haya establecido, indicando la
15
TelefonicaArgentina
which is necessary to create

activitiesthroughtheInboundAPI.
cuota y capacidad disponible en

esa
combinacin
de
timeslotcategora de capacidad.
Tambin incluir el identificador
del bucket, queesnecesariopara
crear actividades a travs de la
APIInbound.
NOTE:pleasereadappendixA1.2 toknowtimeslot
possiblevalues.
NOTA: consultar anexo A1.2 para conocer los

valoresposiblesdetimeslots.
InterfaceAgreement
16
TelefonicaArgentina
4. Inbound Interfaces / Interfaces Inbound

4.1 Create Work Order / Crear Orden de Trabajo
Scope
The Create Work Order (INT_CREATE) interface is
used byMiddlewar tocreatenewWorkOrderswithin
TOAdirect.
mbito
InterfaceProtocol
INT_CREATEinterfaceisSOAPoverhttpmessage.
The behavior andcore xml structure oftheincoming

API are fully described in the Inbound API SDK
document.
MessageFlow
1.MiddlewaresendsamessageusingInboundAPI
2.TOAdirectsendstheresponse
FlujodeMensajes
La interfaz de Creacin de Ordenes de Trabajo

(INT_CREATE) is usada por Middleware para crear
nuevasrdenesdetrabajodentrodeTOAdirect.
INT_CREATEesuninterfazdetipoSOAPsobrehttp.
El comportamiento y la estructura dexmlde la API de
Inbound sedescriben detalladamenteen el documento
APISDKInbound.
1. Middleware enva una peticin utilizando la API
Inbound
2.TOAdirectenvalarespuesta

TherequestwillusetheInbound_interface_request Lapeticinusaraelmtodo
methodwiththefollowingparameters:
Inbound_interface_requestconlossiguientes
<user>structure,asspecifiedintheSDK
parmetros:
<head>structure
estructura<user>talycomoseespecificaen
processing_mode:appointmentonly
elSDK
(fixedvalue)
estructurade<head>
upload_type:incremental(fixed
value)
(valorfijo)
<appointment>structure
upload_type:incremental(valorfijo)
<keys>structurewithonly
estructurade<appointment>
onekey:appt_number
<keys>estructurasolocon
action_if_completed:create
unkey:appt_number
<inventory>structure(mandatory
action_if_completed:create
evenifinventoryisnotused)
estructura<inventory>(obligatorio
inclusosielinventarionoesusado)
onekey:invsn(fixedvalue)
estructura<keys>consolo
propertiesmode:update
unkey:invsn(valorfijo)
<data>structureasspecifiedinSDK,with
oneormorecommands
estructura<data>talycomoseespecificaen
<command>structure
elSDK,conunoomascommands
type:update_activity(fixedvalue)
estructuradel<command>
date:appointmentdate
type:update_activity(valorfijo)
external_id:bucketidentifier
date:fechadecompromiso
fallback_external_id:Zona0(fixed
external_id:identificadordelbucket
value)
fallback_external_id:Zona0(valor
.
fijo)
Eachcommandhasone<appointment>
Cadacomandotieneunaestructurade
structurethatwillcontainthefieldsand
<appointment>quecontienecamposy
propertiesdefinedindatastructures
propiedadesdefinidosenlahijadeclculo
spreadsheet.Pleasereadthat
data_structures.Consultardichahoja
InterfaceAgreement
17
TelefonicaArgentina
spreadsheettoknowthemandatory
fieldsforeachordertype.
SomeproperiesvaluesareencodedinXML
format.Expectedformatforeachoneof
thesepropertiesisspecifiedinappendix
A1.3
Insidetheappointmentstructureitis
possibletocreatelinkedactivitisSDK
documentspecifieshowtolinkanactiviy
withanother,andlinktypesthatcanbeused
arespecifiedinAppendixA3.
parasaberqucampossonobligatorios
paracadatipodeorden.
Elvalordealgunaspropiedadessecodifica
enformatoXML.Elformatoesperadode
cadaunadeesaspropiedadesest
especificadoenelapndiceA1.3
Dentrodelaestructuraappointmentes
posiblecrearactividadesvinculadas.ElSDK
especificacmovincularunaactividadcon
otra,ylostiposdevnculosautilizarse
detallanenelApndiceA3.
Theresponsewillincludethefollowing:
<user>structure,asdescribedinSDK
<head>structure,asdescribedinSDK
<data>structure,asdescribedinSDK
Larespuestalincluir:
<user>structure,comosedescribeenelSDK
<head>structure,comosedescribeenelSDK
<data>structure,comosedescribeenelSDK
InterfaceAgreement
18
TelefonicaArgentina
4.2 Modify Work Order / Modificar Orden de Trabajo

Scopeoftheinterface
The Modify Work Order (INT_MODIFY)interface
is used by Middlewaretoupdatepropertiesofthe
workorder.
NOTE: work order reschedule is achieved also

through this interface. When rescheduling, it is
important
to
set
XA_PENDING_EXTERNAL_ACTION propertyas
null.
AlcancedelaInterfaz
ElinterfazdeModificacindeOrdendeTrabajo
(INT_MODIFY)esutilizadoporelMiddlewarepara
actualizarpropiedadesdelaordendetrabajo.
NOTA:unreagendamientodeunaordenserealiza
tambinconestainterfaz.Esimportanteque
cuandosereagende,adicionalmentesedebe
establecercomonuloelvalordelapropiedad
XA_PENDING_EXTERNAL_ACTION.
InterfaceProtocol
INT_MODIFY interface is SOAP over http
message.
The behavior and core xml structure of the

incoming API are fully described in the Inbound
APISDKdocument.
MessageFlow
1.MiddlewaresendsamessageusingInbound
API
FlujodeMensajes
INT_MODIFYesuninterfazdetipoSOAPsobre
http.
ElcomportamientoylaestructuradexmldelaAPI
deInboundsedescribendetalladamenteenel
documentoAPISDKInbound.
1.MiddlewareenvaunapeticinutilizandolaAPI
Inbound

Therequestwillusethe
Inbound_interface_requestmethodwiththe
followingparameters:
<head>structure
processing_mode:appointment
only(fixedvalue)
upload_type:incremental(fixed
value)
<keys>structurewith
onlyonekey:
appt_number
action_if_completed:
update
<keys>structurewith
onlyonekey:invsn(fixed
value)
<data>structureasspecifiedinSDK,with
InterfaceAgreement
Lapeticinutilizarelmtodo
inbound_interface_requestconlossiguientes
parmetros:
estructura<user>comoseespecificaenel
SDK
estructura<head>
processing_mode:appointment
only(valorfijo)
upload_type:incremental(valor
fijo)
estructura<appointment>
<keys>estructuraconslo
unkey:appt_number
action_if_completed:
update
estructura<inventory>(obligatoria
inclusosinoseusainventario)
estructura<keys>conslo
unkey:invsn(valorfijo)
estructura<data>comoseespecificaenel
SDK,withunoomscommands
19
TelefonicaArgentina
oneormorecommands
Each<command>willcontain:
type:update_activity(fixedvalue)
one<appointment>structurethat
willcontaintheappt_numberfield
toidentifytheworkordertobe
modified,andalsoallthefields
andpropertiesthatwillbe
modified(readdatamodel
documenttolearnmoreabout
eachfieldanditspossible
values,andSDKdocumentfor
moreinformation).
Cada<command>contendr:
type:update_activity(valorfijo)
unaestructura<appointment>que
contendrelcampoappt_number
paraidentificarlaordendetrabajo
amodificar,ytambinloscampos
ypropiedadesquesern
modificados(leerdocumentacin
delmodelodedatosparasaber
msacercadelosposibles
valores,yelSDKpara
informacinadicional).

Larespuestaincluir:
estructura<user>,comosedescribeenelSDK
estructura<head>,comosedescribeenel
SDK
estructura<data>,comosedescribeenel
SDK
InterfaceAgreement
20
TelefonicaArgentina
4.3 Cancel Work Order / Cancelacin Orden de Trabajo

Scopeoftheinterface
AlcanceladeInterfaz
The CancelWork Order (INT_CANCEL)interfaceis

used by Middleware to cancel Work Orders within
TOAdirect. NOTE: it is only possible to cancel
ordersinpendingstatus.
Lainterfazdecancelacinderdenesdetrabajo
(INT_CANCEL)esusadaporelMiddlewarepara
cancelarrdenesdetrabajodentrodeTOAdirect.
NOTA:sloesposiblecancelarrdenesenestado
pendiente.
InterfaceProtocol
INT_CANCELinterfaceisSOAPoverhttpmessage.
INT_CANCELesuninterfazdetipoSOAPsobrehttp.
The behavior andcore xmlstructureoftheincoming

API are fully described in the Inbound API SDK
document.
MessageFlow
1.MiddlewaresendsamessageusingInboundAPI
FlujodeMensajes
ElcomportamientoylaestructuradexmldelaAPIde
Inboundsedescribendetalladamenteeneldocumento
APISDKInbound.
1.MiddlewareenvaunapeticinutilizandolaAPI
Inbound

TherequestwillusetheInbound_interface_request
methodwiththefollowingparameters:
<head>structure
(fixedvalue)
upload_type:incremental(fixedvalue)
onekey:appt_number
action_if_completed:update
onekey:invsn(fixedvalue)
<data>structureasspecifiedinSDK,withone
ormorecommands
<command>structure
type:cancel_activity(fixedvalue)
one<appointment>structurethatwill
containtheappt_numberfieldto
identifytheworkordertobecancelled
LapeticinutilizarelmtodoInbound_interface_request
conlossiguientesparmetros:
estructura<user>,comoseespecificaenelSDK
estructura<head>
(valorfijo)
upload_type:incremental(valorfijo)
estructura<appointment>
<keys>estrucutraconsloun
key:appt_number
action_if_completed:update
estructura<inventory>(obligatoria
inclusosinoseusainventario)
<keys>estructuraconsloun
key:invsn(valorfijo)
<data>estructuratalcualseespecifcaenelSDK,
conunoomscommands
estructura<command>
type:cancel_activity(valorfijo)
unaestructura<appointment>que
contendrelcampoappt_numberpara
identificarlaordenquevaacancelarse
InterfaceAgreement
Larespuestaincluir:
estructura<user>,comosedescribeenelSDK
estructura<head>,comosedescribeenel
21
TelefonicaArgentina
SDK
estructura<data>,comosedescribeenel
SDK
InterfaceAgreement
22
TelefonicaArgentina
5. Outbound Interfaces / Interfaces Outbound
The section describes the Outbound interface from

TOAdirecttoMiddleware.
EstaseccindescribelainterfazdeOutboundde
TOAdirectaMiddlewareOSM.
Payattentiontotheencodingforoutgoingmessages.
Pongaatencinalacodificacinparamensajes
salientes.
IMPORTANT. TOAdirect does care about status of

the messages it sends. Message recipient system
should beable to providethisinformation.Alongwith
send_message,TOAdirect expects recipient system
to have the following methods implemented:
drop_message, get_message_status. These
methods availability on the recipient side isrequired
for successful certification process completion.
Additionally, set_message_status method can be
usedfordeliveringmessagestatustoTOAdirect.
IMPORTANTE.TOAdirectsepreocupaporel
estadodelosmensajesqueenva.Elsistemade
destinodebesercapazdeproporcionaresta
informacin.Juntoconsend_message,TOAdirect
esperaqueelsistemareceptortengalossiguientes
mtodosimplementados:drop_message,
get_message_status.Serequieredisponibilidad
deestosmtodosenelladoreceptorpara
completarelprocesodecertificacinconxito.
Adems,elmtodoset_message_statussepuede
utilizarparalaentregadeestadodelmensajea
TOAdirect.
Please use Outbound SDK document to see full

descriptionofoutboundmethods. Telefonica will use
the advanced workflow described in theOutbound
document.
UtiliceeldocumentoSDKdeOutboundparaverla
descripcincompletadelosmtodosdesalida.
Telefnicautilizarelworkflowavanzadodescrito
eneldocumentodeSDKdeOutbound.
5.1 Outgoing Message Structure / Estructura del Mensaje de Salida

Eachoutgoingmessagehastwomaincomponents:
Subject:definesthescopeofthemessage
Body: contains the parameters of the
message(embeddedinthe<body>tag )
Generalstructureofmessage:
Cada mensaje de salida tiene dos componentes

principales:
Subject:defineelmbitodelmensaje
Body: contiene los parmetros delmensaje
(embebidosenunaetiqueta<body>
Estructurageneraldelmensaje:
InterfaceAgreement
23
TelefonicaArgentina
5.2 Outgoing Message Response Structure / Estructura de Respuesta al Mensaje de

Salida
Response messages (delivered, sent, failed) will
havethestructuredescribedinOutboundSDK
Losmensajes de respuesta(delivered,sent,failed)
tendrnlaestructuradescritaenelSDKOutbound.
5.3 Status Change / Cambio de Estado
Descripcin
Description
Statuschangeoutboundmessagewillbesent
whenactivitystatushaschanged.
MessageFlow
Themessageflowisasfollows:
Elmensajedecambiodeestadodeoutboundser
enviadocuandoelestadodeactividadcambia.
FlujodeMensajes
Elflujodemensajesescomosigue:
TOAdirectsendsOutboundAPIrequest
Method:send_message
Middlewarereturnsresponse
TOAdirect enva una peticina travs delaAPI

Outbound
Method:send_message
Middlewaredevuelveunarespuesta
DeliverySchedule
Numberofsendattempts:1
Timeinterval:0minutes
Thesystemwillsendthemessagetothe
middlewareonlyonceandincaseofFailure
statusintheresponsenofurtherattempttosend
themessagewillbedone.Allerrorhandlingwill
beundertheMiddlewareresponsibility.
PlanificacindeEnvo
Nmerodeintentosdeenvo:1
Intervalodetiempo:0minutos
El sistema enviar el mensaje al middlewareslouna
vezyenelcasodelestadode "fracaso"enlarespuesta
no se realizar un nuevo intento para enviar el
mensaje. Todo el manejo de errores quedar bajo la
responsabilidaddelMiddleware.
Conditions
MessageneedstobesentforallCustomer
Activitiesthathavenotbeenenteredmanually.
Condiciones
El Mensaje debe ser enviado a todas lasactividades
delclientequenosehanintroducidomanualmente
XMLEncoding
CondificacinXML
InthecaseswhereXMLshouldbeinsidethe
<body>tag,OutboundAPIwillNOTencodetags
withcharacterspecialsandwillleavetheXML
asdefined.
EnloscasosenlosquehayXMLdentrodelaetiqueta
<body>,laAPIInboundnocodificarlstagscon
caracteresespecialesydejarelXMLtalycomoest
definido.
Structureofthemessage
EstructuradelMensaje
LaestructuraserlaespecificadaenelSDKconlos
siguientessubject/bodydependiendodeevento:
ThestructurewillbeasspecifiedintheSDKwith
thefollowingsubject/bodydependingonthe
event:
Event
Evento
InterfaceAgreement
Condition
Condicin
Subject
24
TelefonicaArgentina
OrderCompleted
OrdenCompletada
TOA_OUTBOUND_CHANGE_STATUS
OrderNotDone
OrdenNoRealizada
OrderSuspended
OrdenSuspendida
Event
Evento
Body
OrderCompleted,
OrderSuspended
orOrderNotDone
Orden
Completada,
OrdenSuspendida
uOrdenNo
Realizada
<![CDATA[
<CHANGE_STATUS>
<property>
<label>propertylabel</label>
<value>propertyvalue</value>
</property>
<property>
<label>propertylabel</label>
<value>propertyvalue</value>
</property>
<!(...)
all properties as specified in data structures spreadsheet , in the same order as the
spreadsheet>
</CHANGE_STATUS>
]]>
Textinbluewillbereplacedwithactualpropertylabelsandvalues/Eltextoenazulserreemplazadoporlas
etiquetasyvaloresrealesdelaspropiedades
InterfaceAgreement
25
TelefonicaArgentina
6. Activity Interfaces / Interfaces Activity

6.1 Get Work Orders / Obtener rdenes de Trabajo
Scope
The Get WorkOrder (INT_QUERY)interfaceisused

byMiddleware to retrieve theworkordersproperties
thatmatchcertaincriteria
InterfaceProtocol
INT_QUERYinterfaceisSOAPoverhttpmessage.
mbito
LainterfazdeObtenerOrdendeTrabajo
(INT_QUERY)esusadaporMiddlewarepara
consultarlaspropiedadesdelasrdenesdetrabajo
quecumplaniunciertocriterio.
INT_QUERYesuninterfazdetipoSOAPsobrehttp.
The behavior andcore xml structure oftheincoming

API are fully described in the Activity API SDK
document
MessageFlow
FlujodeMensajes
1.Middlewaresendsaget_activitiesmessageusing
ActivityAPI
ElcomportamientoylaestructuradexmldelaAPI
deInboundsedescribendetalladamenteenel
documentoAPISDKActivity.
1.Middlewareenvaunmensajeget_activities
RequestStructure
Therequestwillusethesearch_activitiesmethod
specifyingsearchcriteria(seeappendixA2.6.1)
EstructuradelaPeticin
Elrequerimientousaraelmtodosearch_activities
especificandoloscriteriosquedebecumplirlabsqueda
(verejemploenelapndiceA2.6.1)
ResponseStructure
get_activities_responsewillinclude:
<result_code>,asspecifiedinActivitySDK
<activities> structure with oneormore<activity>
structureforeachactivitythatmatchthecriteria
each <activity> structure will contain one or
more<properties>structures
each <properties> structure will contain one
<name>and<value>
EstructuradelaRespuesta
get_activities_responseincluir:
<result_code>, tal y como se especifica en el
SDKActivity
estructura <activities> que contiene una o ms
una estructuras<activity>porcadaactividadqeu
cumplaelcriterio
Cadaestructura <activity> contendr una o ms
estructuras <properties> que tenga un valor no
nulo
cada estructura <properties> contendr un
<name>y<value>
InterfaceAgreement
26
TelefonicaArgentina
6. Approvals / Aprobaciones
TelefnicaArgentina
Name
Signature:
Date:
DanielLacherra
AndrsContona
TOATechnologies/Indra
Name
Signature:
Date:
FelipePoncet
JavierLlobet
InterfaceAgreement
27
TelefonicaArgentina
7. Certification Test Plan / Plan de Pruebas de Certificacin

TheCertificationTestplanconsistsoftwophases:
1.
AcceptanceTestingverifythebasic
functionality,errorhandlinganderrorresponse.
2.
PerformanceTestingverify
responsivenessandstabilityunderaparticular
workload.Itincludesverificationofpeaklevelsof
activity.
Elplandetestcertificacinsecomponede2
fases:
1.TestdeAceptacinVerificarlas
funcionalidadesbsicas,manejodeerroresy
respuestas.
2.TestdePerformanceVerificarlavelocidadde
respuestayestabilidadbajocondiciones
particularesdecarga.Estoincluyeverificacinde
nivelespeakdeactividad.
NotethattheinterfacemustsuccessfullypassAcceptanceTestingphasebeforePerformanceTestingphasecanbegin.
Schedule
Steps
Sanity
Check
In1
In2
In3
In4
Cap1
Cap2
Out1
Out2
Out3
Out4
Planned
Date/Time
0thday
Notes
dd/mm/yyyy
hh:mm
TherealsocanbeinformationaboutWOnumber,providerID,bucket,timeperiodwhen
transactionsweresent
Configuration/Connectivitychecks
InboundAPIcertification/CertificacindeAPIInbound
InterfaceAgreement
28
TelefonicaArgentina
ThepurposeoftheAcceptanceTestforrequeststhe
integratorsendtoTOAdirectistocheckthatthe
requestsarevalidanderrorsarehandledonclients
side.
ElobjetivodelTestdeAceptacinparaelladodel
clienteenlosrequerimientoshaciaTOAdirectes
comprobarquelassolicitudessonvlidosylos
erroressemanejanenelladodelcliente
#
Objective
In
Verifycreatetransactionfrom
TelefonicaARtoTOAdirect
Instructions
Actual
Result
ExpectedResult
Integratorsendsasingle
validtransaction.
Therequestisvalid.
Therequestisnotduplicated(thereisno
manyrequestsinsteadofone)
Noerrorswereencounteredorrecorded
duringtest.
In
Verifyupdatetransactionfrom
validtransaction.
Therequestisvalid.
duringtest.
In
Verifycanceltransactionfrom
validtransaction.
Therequestisvalid.
duringtest.
In
Verifynotdonetransactionfrom
validtransaction.
Therequestisvalid.
duringtest.
ThepurposeofthePerformanceTestforrequeststhe
clientssendtoTOAdirectistocheckthatpeakvolumeof
incomingtransactioncanbeloadedtoTOAdirectduring
periodoftimeacceptablefortheclient.Theperformance
requirementsispartofBRSandSRSInterface.
ElobjetivodelTestdePeerformanceparalos
requerimientosdelclienteenviadosaTOAdirectes
validarqueenunpeakdevolumendetransaccionesde
entradapuedensercargadasenTOAdirectduranteun
periododetiempoaceptableparaelcliente.Los
requerimientosdeperformaceespartedelBRSySRS.
Objective
In
VerifythecapabilityofTelefonicaARto
sendpeakvolumeoftransactionto
TOAdirect.
Instructions
Integratorsends200valid
transactionstoTOAdirect
InterfaceAgreement
29
Actual
Result
ExpectedResult
TheTelefonicaARsendsnotless
than50transactionsduring60
seconds.
duringtest.
TelefonicaArgentina
CapacityAPIcertification
ThepurposeoftheAcceptanceTestforrequeststhe
integratorsendtoTOAdirectistocheckthatthe
side.
Elobjetivodeltestdeaceptacinesqueel
integradorderequerimientoslosenveaTOAdirect
paravalidarquelosrequerimientossonvlidosylos
erroressonmanejadosenelladodelcliente.
#
Cap
Objective
Instructions
Verifyget_capacitytransactionfrom
validtransaction.
Actual
Result
ExpectedResult
Therequestisvalid.
duringtest.
ThepurposeofthePerformanceTestforrequeststheclientssendtoTOAdirectistocheckthatpeakvolumeofincoming
transactioncanbeloadedtoTOAdirectduringperiodoftimeacceptablefortheclient.
Actual
#
Objective
Instructions
ExpectedResult
Result
Cap
VerifythecapabilityofTelefonicaARto
Integratorsends300valid
TheTelefonicaARsendsnotless
sendpeakvolumeoftransactionto
than100transactionsduring60
TOAdirect.
seconds.
Noerrorswereencounteredor
recordedduringtest.
InterfaceAgreement
30
TelefonicaArgentina
OutboundAPIcertification/CertificacindeAPIOutbound
ThepurposeoftheAcceptanceTestforrequests
theintegratorsendtoTOAdirectistocheckthatthe
side.
Elobjetivodeltestdeaceptacinesenviarlos
requerimientosaTOAdirectparavalidarlos
requerimientosyelmanejodeerroresenelladodel
cliente.
InterfaceAgreement
31
TelefonicaArgentina
ThepurposeoftheAcceptanceTestforrequeststheTOAdirectsendstoTelefonicaARis
tochecktheclientsresponse
#
Out
Objective
VerifythatTelefonicaAR
acceptsamessagefrom
TOAdirect
Instructions
ExpectedResult
HowtoDo:Integratorperformsan
actionsthattriggertheoutbound
message(e,gcompleteoraddan
activity).
Clientssystemacceptsthemessageandsend
thevalidresponsetoTOAdirect
Avalidmessageissentto
TelefonicaAR
Out
Out
acceptsget_message_status
requestfromTOAdirect
acceptsadrop_message
requestfromTOAdirect
Actual
Result
Client'ssystemsendssendingstatusinthe
''send_message_response.Afinalstatusis
returnedbyset_message_status.
duringtest.
HowtoDo:TOAperformsan
actiontosendget_message_status
requesttoclientssystem.
Clientssystemacceptthemessageandsend
TelefonicaAR
duringtest.
HowtoDo:TOAperformsan
actiontosendadrop_message
requesttoclientssystem.
Clientssystemacceptthemessageandsend
TelefonicaAR
duringtest.
ThepurposeofthePerformanceTestforrequeststhatTOAdirectsendstoTelefonicaARistocheckthatmessagestatus
ofoutboundtransactionaresetinTOAdirectforpeakvolume.
Actual
#
Objective
Instructions
ExpectedResult
Result
Out
Verifyresponsivenessofclients HowtoDo:Justupload2000
Theclientssystemresponsivenessmatches
systeminrealpeakmode.
requirements350messagesper60
activitiesand2000messages
second.
willbecreated.
Integratorreceives1000valid
duringtest.
InterfaceAgreement
32
TelefonicaArgentina
A1. Properties Details / Detalle de Propiedades

This section describes the custom properties that
must be used in each interface. Formal definition
foreachpropertycanbefoundindatamodel.
Esta seccin describe las propiedades a medida que

deben ser utilizadas en cada interfaz. La definicin
formal de cada propiedad est en el modelo de datos.
These propertiesareconfiguration dependentand

therefore configuration changes can affect to this
section'sdefinition.
Estas propiedades son dependientes de la

configuracin y por lo tanto cambios en la
configuracin pueden afectar a lo definido en esta
seccin.
A1.1 Capacity Query Properties / Propiedades de la Consulta de Capacidad

Capacityqueriesmustincludethefollowing
properties(pleasereadeachpropertypossible
valuesinthedatamodel).
Lasconsultasdecapacidaddebenincluirlassiguientes
propiedades(consultarlosvaloresposiblesdecada
propiedadenelmodelodedatos).
NOTE:allpropertiesfromthislistmustbealways
sent.Ifvalueisunlknownthenitmustbesentas
null:<value></value>
NOTA:Todaslaspropiedadesdeestalistadeben
enviarsesiempre.Sinoseconoceelvalorentonces
debeenviarseigualmentecomonulo:<value></value>
RequestField/Property
Campo/PropiedaddelaPeticin
Comment
Comentario
XA_WORK_ZONE_KEY
Thismandatorypropertymustbe
filledconcatenatingcentralcodeand
blockcodewiththeundescore
symbolbetween(e.g.41_2124)orin
caseonlycentralcodeisknown,then
thecentralalonewithnosymbol(e.g.
41)
TOAdirectwillusethisproperty,
togetherwithrequiredworkskills,to
calculatethebucket
Enestapropiedadobligatoriase
debecolocarlacocatenacindel
cdigodecentralyelcdigode
manzanaconelsmbolounderscore
entreambos(ejemplo:41_2124),o
enelcasodequesloseconozcala
central,lacentralslamentesin
ningnsmbolo(ejemplo:41)
TOAdirectutilizarestapropiedad,
juntoconlashabilidadesdetrabajo
requeridas,paracalcularelbucket
XA_CENTRAL
TOAdirectwillusethismandatory
propertytocalculatepredictedtravel
time
TOAdirectutilizarestapropiedad
obligatoriaparacalculareltiempo
deviajeestimado
XA_QUADRANT
ReadsectionA1.4Quadrant
CalculationMethod.
propertytocalculatepredictedtravel
time
VerseccinA1.4MtododeClculo
delCuadrante.
obligatoriaparacalculareltiempo
deviajeestimado
worktype_label
Activitytypeaccordingtothecatalog
propertytocalculateactivityrequired
workskills.
TIpodeactividaddeacuerdoal
catlogo
obligatoriaparacalcularlas
habilidadesdetrabajorequeridas.
InterfaceAgreement
33
TelefonicaArgentina
XA_WORK_TYPE
Worktypeaccordingtothecatalog.
workskills.
cdigodeactuacindeacuerdoal
catlogo
XA_MULTIPRODUCTO
Propertythatrepresentsthebundle
ofproductsinasinglestring.
workskills.
Propiedadquerepresentaun
conjuntodeproductosenunacadena
nica.
XA_ACCESS_TECHNOLOGY
workskills.
XA_QUALITY_FAMILY
TOAdirectwillusethispropertyto
calculateactivityrequiredworkskills.
paracalcularlashabilidadesde
trabajorequeridas.
XA_TERMINATION_TYPE
trabajorequeridas.
XA_CURRENT_DIAGNOSIS
trabajorequeridas.
XA_BROADBAND_TECHNOLOGY
workskills.
XA_TELEPHONE_TECHNOLOGY
workskills.
XA_TV_TECHNOLOGY
workskills.
XA_COMPANY_NAME
trabajorequeridas.
XA_CUSTOMER_SEGMENT
trabajorequeridas.
XA_CUSTOMER_TYPE
trabajorequeridas.
XA_ACCESSORIES_EQUIPMENT_
SKILLS
trabajorequeridas.
InterfaceAgreement
34
TelefonicaArgentina
A1.2 Time Slot Identifiers / Identificadores de los Time slots

Thesearethetimeslotsinitiallydefined.Thename
isauniqueidentifierofthetimeslot.
Inthefutureifnewslotsareadded,theywillhave
theformatHH24:MMHH24:MM.Forexample,ifa
timeslotfrom3pmto5pmwouldhavethename
15:0017:00
Estassonlasfranjasdetiempodefinidas
inicialmente.Elnombreesunidentificadornico
deltimeslot.
Sisedefinennuevasfranjasposteriormente,estas
tendrnelformatoHH24:MMHH24:MM.Por
ejemplounafranjahorariade3pma5pmtendrael
identificador15:0017:00
Name/Nombre
TimeInterval/IntervalodeTiempo
AM
8:0012:00
PM
12:0017:00
A1.3 Inbound XML Properties / Propiedades XML de Inbound

Thefollowingarereadonlypropertiesthatwillbe
receivedinXMLformat.TOAdirectwillperform
XSLTtransformationsforvisualizinginHTML
format.
Lassiguientespropiedadessonpropiedadesdeslo
lecturaquesernrecibidasenformatoXML.TOAdirect
aplicartransformacionesXSLTparavisualizarlasen
formatoHTML.
Propertyname/Nombre
propiedad
Propertyformat/Formatodelapropiedad
XA_ADSL_DATA
<label>XA_ADSL_DATA</label>
<value><![CDATA[
<XA_ADSL_DATA>
<DslamRack>A</DslamRack>
<DslamShelf>B</DslamShelf>
<DslamSlot>C</DslamSlot>
<DslamPort>D</DslamPort>
<BlockPots>E</BlockPots>
<PinPots>F</PinPots>
<BlockAdsl>G</BlockAdsl>
<PinAdsl>H</PinAdsl>
</XA_ADSL_DATA>
]]></value>
XA_COPPER_DATA
<label>XA_COPPER_DATA</label>
<value><![CDATA[
<XA_COPPER_DATA>
<ManzanaCaja>A</ManzanaCaja>
<DomicilioCaja>B</DomicilioCaja>
<Caja>C</Caja>
<ParDesde>D</ParDesde>
<ParHasta>D</ParHasta>
InterfaceAgreement
35
TelefonicaArgentina
<CablePrimario>E</CablePrimario>
<ParPrimario>F</ParPrimario>
<DomicilioArmario>G</DomicilioArmario>
<Armario>H</Armario>
<ParSecundario>I</ParSecundario>
</XA_COPPER_DATA>
]]></value>
XA_MDF_DATA
<label>XA_MDF_DATA</label>
<value><![CDATA[
<XA_MDF_DATA>
<NumeroEquipoIP>C</NumeroEquipoIP>
<CoordenadaHorizontal>D</CoordenadaHorizontal>
</XA_MDF_DATA>
]]></value>
XA_PRODUCTS_SERVICES
<label>XA_PRODUCTS_SERVICES</label>
<value><![CDATA[
<XA_PRODUCTS_SERVICES>
<ProductService>
<Codigo>A</Codigo>
<Descripcion>B</Descripcion>
</ProductService>
<ProductService>
<Codigo>A</Codigo>
<Descripcion>B</Descripcion>
</ProductService>
...
</XA_PRODUCTS_SERVICES>
]]></value>
XA_NOTE
<label>XA_NOTE</label>
<value><![CDATA[
<XA_NOTE>
<Observacion>
<Fecha>A1</Fecha>
<Texto>B1</Texto>
</Observacion>
<Observacion>
<Fecha>A2</Fecha>
<Texto>B2</Texto>
</Observacion>
<Observacion>
<Fecha>A3</Fecha>
<Texto>B3</Texto>
</Observacion>
</XA_NOTE>
]]></value>
XA_FO_DATA
<label>XA_FO_DATA</label>
<value><![CDATA[
<XA_FO_DATA>
<FibraOptica>A</FibraOptica>
InterfaceAgreement
36
TelefonicaArgentina
<LineaFibra>B</LineaFibra>
<TipoEmplazamiento>A</TipoEmplazamiento>
<CentralFibra>I</CentralFibra>
<CableFibra>I</CableFibra>
<Manzana>I</Manzana>
<Caja>I</Caja>
<TipoCaja>I</TipoCaja>
<Tramo1>I</Tramo1>
<Tramo2>I</Tramo2>
<Tramo3>I</Tramo3>
</XA_FO_DATA>
]]></value>
XA_PREVENTIVE_DATA
<label>XA_PREVENTIVE_DATA</label>
<value><![CDATA[
<XA_PREVENTIVE_DATA>
<NumeroBajadas>A</NumeroBajadas>
<NumeroCruzadas>B</NumeroCruzadas>
<NumeroModulos>C</NumeroModulos>
</XA_PREVENTIVE_DATA>
]]></value>
XA_CURRENT_PRODUCTS_
SERVICES
<label>XA_CURRENT_PRODUCTS_SERVICES</label>
<value><![CDATA[
<XA_CURRENT_PRODUCTS_SERVICES>
<ProductService>
<Codigo>A1</Codigo>
<Descripcion>B1</Descripcion>
</ProductService>
<ProductService>
<Codigo>A2</Codigo>
</ProductService>
<ProductService>
<Codigo>A3</Codigo>
</ProductService>
</XA_CURRENT_PRODUCTS_SERVICES>
]]></value>
XA_EQUPMENT
<label>XA_EQUIPMENT</label>
<value><![CDATA
<XA_EQUIPMENT>
<Equipment>
<IdEquipo>A1</IdEquipo>
<TipoEquipo>B1</TipoEquipo>
<Cantidad>C1</Cantidad>
</Equipment>
<Equipment>
</Equipment>
<Equipment>
InterfaceAgreement
37
TelefonicaArgentina
</Equipment>
</XA_EQUIPMENT>
]]></value>
XA_ACCESSORIES
<label>XA_ACCESSORIES</label>
<value><![CDATA
<XA_ACCESSORIES>
<Accessory>
<Id>A1</Id>
<Entregar>D1</Entregar>
</Accessory>
<Accessory>
<Id>A2</Id>
</Accessory>
<Accessory>
<Id>A3</Id>
</Accessory>
</XA_ACCESSORIES>
]]></value>
A1.4 Quadrant Calculation Method / Mtodo de Clculo del Cuadrante

Quadrantidentifierwillbetheconcatenationof
XgridwithYgrid,withacolonbetween.
Xgrid:Ygrid
ElidentificadordebeserlaconcatenacindeXgridcon
Ygrid,poniendodospuntosenmedio.Xgrid:Ygrid.
Ejemplodecuadrante:23:12
Quadrantexample:23:12
Constants/Constantes:
CellSize=2(kilometers/kilmetros)
Longitude_pivot=65.9144821
Latitude_Pivot=38.147194
Note:pivotistheconsideredthegeographicalcenterofArgentina(Puelches)
Nota:pivoteselpuntoconsideradoelcentrogeogrficodeArgentina(Puelches)
Quadrantformulas/Frmulasdelcuadarate
quadrantId=Xgrid:Ygrid(example/ejemplo:72:23)
Xgrid = round((1000 / 9) * cos(Latitude * pi / 180) * (Longitude
Longitude_Pivot)/CellSize)
Ygrid=round((1000/9)*(LatitudeLatitude_Pivot)/CellSize)
InterfaceAgreement
38
TelefonicaArgentina
A1.5 Effort Code / Cdigo de Esfuerzo

Effortcodeisgeneratedasfollows:
Elcdigodeesfuerzosecalculadelasiguienteforma:
ProvisionActivities
ActividadesdeProvisin
Effortcodewillbethesameasspecifiedin
XA_MULTIPRODUCTproperty.
Elcdigodeesfuerzoserelmismovalorquesecoloca
enlapropiedadXA_MULTIPRODUCTO
CorrectiveMaintenance,Quality,MDFand
Splicingactivities
ActividadesdeMantenimientoCorrectivo,
Sobrestancia,RepartidoryEmpalmadores
Generalrule:effortcodewillbethesameas
worktype(XA_WORK_TYPEpropertyvalue)
Reglageneral:elcdigodeesfuerzoserelmismoque
elcdigodeactuacin(valordelapropiedad
XA_WORK_TYPE)
ActividadesdeMantenimientoPreventivo
PreventiveMaintenanceActivities
effortcodewillbethesameasworktype
(XA_WORK_TYPEpropertyvalue)
Reglageneral:elcdigodeesfuerzoserelmismoque
elcdigodeactuacin(valordelapropiedad
XA_WORK_TYPE)
Exception:ifactivityincludesanumberof
modules,crossings,etc.thenconcanatethe
followingvaluesinthisorder:
1. worktype
2. _(underscore)
3. numberofcrossings,modulesor
drainpipes
Excepcin:silaactividadincluyenmerodecruzadas,
nmerodemdulosobajadas,entoncesconcatenarlos
siguientesvaloresenesteorden:
1. cdigodeactuacin
2. _(underscore)
3. nmerodecruzadas,mdulosobajadas
Ejemplo:untrabajodetipoaceptacincaja(cdigode
actuacin:PRE_BOX_E)tendrcomocdigode
esfuerzo:
Example:aworktypeofacceptbox(worktype:
PRE_BOX_E)willhavethiseffortcode:
PRE_BOX_E
PRE_BOX_E
Ejemplo:undesvodebajadas(cdigodeactuacin
PRE_DISP_NET_E)con3bajadastendrcomocdigo
deesfuerzo:
Example:adrainpipedeviation(worktype:
PRE_DISP_NET_E)with3drainpipeswillhave
thiseffortcode:
PRE_DISP_NET_E_3
PRE_DISP_NET_E_3
InterfaceAgreement
39
TelefonicaArgentina
A2. Messages Examples / Mensajes de Ejemplo

This document includes messages as examples
forbetterunderstanding.
Este documento incluye mensajes como ejemplo para

facilitar la comprensin.
A2.1 Capacity Query / Consulta de Capacidad
A2.1.1 Capacity Query Request / Solicitud de Consulta de Capacidad

<soapenv:Envelopexmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:urn="urn:toa:capacity">
<soapenv:Header/>
<soapenv:Body>
<urn:get_capacity>

<user>
<now>20140803T11:15:030500</now>
<company>telefonicaar.test</company>
<login>soap</login>
<auth_string>5436fdf1880209bfac7b1e6ecadf1cab</auth_string>
</user>
<date>20140804</date>
<date>20140805</date>
InterfaceAgreement
40
TelefonicaArgentina
<determine_location_by_work_zone>true</determine_location_by_work_zone>
<calculate_travel_time>true</calculate_travel_time>
<calculate_duration>true</calculate_duration>
<calculate_work_skill>true</calculate_work_skill>

<!Fieldsrequiredforbucketcalculation>
<activity_field>
<name>XA_WORK_ZONE_KEY</name>
<value>437</value>
</activity_field>
<!Fieldsrequiredfortimetravelcalculation>
<activity_field>
<name>XA_CENTRAL</name>
<value>319</value>
</activity_field>
<activity_field>
<name>XA_QUADRANT</name>
<value>16:13</value>
</activity_field>
<!Fieldsrequiredfordurationcalculation>
<!Fieldsrequiredforskillscalculation>
<activity_field>
<name>worktype_label</name>
<value>PRO_INSTALL</value>
</activity_field>
<activity_field>
<name>XA_WORK_TYPE</name>
<value>PRO_INSTALL</value>
<activity_field>
<name>XA_ACCESS_TECHNOLOGY</name>
<value>COBRE</value>
</activity_field>
<activity_field>
<name>XA_QUALITY_FAMILY</name>
<value></value>
</activity_field>
<activity_field>
<name>XA_TERMINATION_TYPE</name>
<value>06</value>
</activity_field>
<activity_field>
<name>XA_MULTIPRODUCTO</name>
<value>ADSL+VOIP</value>
</activity_field>
<activity_field>
<name>XA_CURRENT_DIAGNOSIS</name>
InterfaceAgreement
41
TelefonicaArgentina
<value>RREP001</value>
</activity_field>
<activity_field>
<name>XA_TELEPHONE_TECHNOLOGY</name>
<value>TOIP</value>
</activity_field>
<activity_field>
<name>XA_BROADBAND_TECHNOLOGY</name>
<value>ADSL</value>
</activity_field>
<activity_field>
<name>XA_TV_TECHNOLOGY</name>
<value></value>
</activity_field>
<activity_field>
<name>XA_COMPANY_NAME</name>
<value></value>
</activity_field>
<activity_field>
<name>XA_CUSTOMER_SEGMENT</name>
<value></value>
</activity_field>
<activity_field>
<name>XA_CUSTOMER_TYPE</name>
<value></value>
</activity_field>
</urn:get_capacity>
</soapenv:Body>
</soapenv:Envelope>
A2.1.2 Capacity Query Response / Respuesta a la Consulta de Capacidad

<SOAPENV:EnvelopeSOAPENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"
xmlns:SOAPENC="http://schemas.xmlsoap.org/soap/encoding/"xmlns:si="http://soapinterop.org/xsd"
xmlns:ns1="http://toatech.com/toasoap/1.0/"xmlns:tns="NameSpace">
<SOAPENV:Body>
<urn:get_capacity_responsexmlns:urn="urn:toa:capacity">
<activity_duration>90</activity_duration>
<activity_travel_time>15</activity_travel_time>
<capacity>
<location>B_VERNET_PROVISION</location>
<date>20140804</date>
<time_slot>AM</time_slot>
<work_skill>INS_ADSL_COBRE</work_skill>
<quota>120</quota>
<available>120</available>
InterfaceAgreement
42
TelefonicaArgentina
</capacity>
<capacity>
<date>20140804</date>
<work_skill>INS_STB_COBRE</work_skill>
<quota>240</quota>
</capacity>
<capacity>
<date>20140804</date>
<time_slot>PM</time_slot>
<quota>180</quota>
</capacity>
<capacity>
<date>20140804</date>
<quota>60</quota>
</capacity>
<capacity>
<date>20140805</date>
<quota>120</quota>
</capacity>
<capacity>
<date>20140805</date>
<quota>240</quota>
</capacity>
<capacity>
<date>20140805</date>
<quota>180</quota>
</capacity>
InterfaceAgreement
43
TelefonicaArgentina
<capacity>
<date>20140805</date>
<quota>60</quota>
</capacity>
</urn:get_capacity_response>
</SOAPENV:Body>
</SOAPENV:Envelope>
A2.2 Create Order / Creacin de Orden

A2.2.1 Create Order Request / Solicitud de Creacin de Orden
<soapenv:Envelopexmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:urn="urn:toatech:InboundInterface:1.0">
<soapenv:Header/>
<soapenv:Body>
<urn:inbound_interface_request>
<user>
<now>20131017T13:37:030500</now>
<company>telefonicaar.dev</company>
<login>soap</login>
<auth_string>c1dc9ee98c25d3811b5eb91e7abe64ec</auth_string>
</user>
<head>
<processing_mode>appointment_only</processing_mode>
<upload_type>incremental</upload_type>
<appointment>
<keys>
<field>appt_number</field>
<action_if_completed>create</action_if_completed>
</keys>
</appointment>
<inventory>
<keys>
<field>invsn</field>
</keys>
</inventory>
<properties_mode>update</properties_mode>
</head>
<data>
<commands>
<command>
<type>update_activity</type>
<date>20140820</date>
<external_id>BK_ACCESO_VERNET</external_id>
<fallback_external_id>Zona0</fallback_external_id>
<appointment>
<name>FelipePoncet</name>
<customer_number>C638830890</customer_number>
<cell>997903223</cell>
<email>christian.isla@telefonica.com</email>
<phone>7900142</phone>
InterfaceAgreement
44
TelefonicaArgentina
<appt_number>1638830945</appt_number>
<worktype_label>PRO_INSTALL</worktype_label>
<time_slot>0911</time_slot>
<sla_window_start>2014061112:00</sla_window_start>
<sla_window_end>2014061309:00</sla_window_end>
<city>Santiago</city>
<state>Santiago</state>
<coordx>70.6070000</coordx>
<coordy>33.4175000</coordy>
<duration>123</duration>
<address>Moreno870</address>
<city>BuenosAires</city>
<state>BuenosAires</state>
<properties>
<property>
<label>XA_SOURCE_SYSTEM</label>
<value>AMDOCS</value>
</property>
<property>
<label>XA_SALES_POINT_CODE</label>
<value>TCL01</value>
</property>
<property>
<label>XA_SALES_POINT_DESCRIPTION</label>
<value>PuntodeVenta01</value>
</property>
<property>
<label>XA_CONTACT_NAME</label>
<value>ChristianIsla</value>
</property>
<property>
<label>XA_CONTACT_PHONE_NUMBER_2</label>
<value>997903224</value>
</property>
<property>
</property>
<property>
</property>
<property>
<label>XA_INDUSTRY</label>
<value>Mineria</value>
</property>
<property>
<label>XA_CUSTOMER_SEGMENT</label>
<value>RES</value>
</property>
<property>
<label>XA_CUSTOMER_TYPE</label>
<value>0O</value>
</property>
<property>
<label>XA_WORK_TYPE</label>
<value>REP_WLL</value>
</property>
<property>
<label>XA_EFFORT_CODE</label>
<value>PRO_INSTALL_FTTH_BAFO__</value>
</property>
<property>
<label>XA_TERMINATION_TYPE</label>
<value>03</value>
</property>
<property>
InterfaceAgreement
45
TelefonicaArgentina
<label>XA_NUMBER_SERVICE_ORDER</label>
</property>
<property>
<label>XA_ORDER_CREATION_DATE</label>
</property>
<property>
<label>XA_USER</label>
<value>ingrid.gonzales</value>
</property>
<property>
<label>XA_TELEPHONE_TECHNOLOGY</label>
<value>TOIP</value>
</property>
<property>
<label>XA_BROADBAND_TECHNOLOGY</label>
<value>BAFO</value>
</property>
<property>
<label>XA_TV_TECHNOLOGY</label>
<value>IPTV</value>
</property>
<property>
<label>XA_ACCESS_TECHNOLOGY</label>
<value>FTTH</value>
</property>
<property>
<label>XA_CHANNEL_ORIGIN</label>
<value>EjemploCanaldeOrigen</value>
</property>
<property>
<label>XA_WIRING_CABINET</label>
<value></value>
</property>
<property>
<label>XA_OLT</label>
<value></value>
</property>
<property>
<label>XA_CENTRAL</label>
<value>BARRACAS</value>
</property>
<property>
<label>XA_CENTRAL_NAME</label>
<value>41</value>
</property>
<property>
<label>XA_BLOCK</label>
<value>406</value>
</property>
<property>
<label>XA_ADDRESS_VERTICAL</label>
<value>Piso14PuertaA</value>
</property>
<property>
<label>XA_WORK_ZONE_KEY</label>
<value>41_406</value>
</property>
<property>
<label>XA_RURAL</label>
<value>1</value>
</property>
<property>
<label>XA_RED_ZONE</label>
<value>1</value>
</property>
<property>
InterfaceAgreement
46
TelefonicaArgentina
<label>XA_QUALITY_FAMILY</label>
<value>BAS</value>
</property>
<property>
<label>XA_PLANE</label>
<value>ABCD</value>
</property>
<property>
<label>XA_DOMICILIARY_MAINTENANCE</label>
<value>0</value>
</property>
<property>
<label>XA_TECHNICAL_VALIDATION</label>
<value>1</value>
</property>
<property>
<label>XA_COMMERCIAL_VALIDATION</label>
<value>1</value>
</property>
<property>
<label>XA_REPEATED</label>
<value>2</value>
</property>
<property>
<label>XA_DIAGNOSIS</label>
<value>B</value>
</property>
<property>
<label>XA_MULTIPRODUCTO</label>
<value>ADSL+VOIP</value>
</property>
<property>
<label>XA_LEVEL_URGENCY</label>
<value>1</value>
</property>
<property>
<label>XA_PRIORITY</label>
<value>1</value>
</property>
<property>
<label>XA_ADDRESS_COMPLEMENT</label>
<value>EjemploEntreCalles</value>
</property>
<property>
<label>XA_INTERNAL_NUMBER</label>
</property>
<property>
<label>XA_FLOOR</label>
<value>1</value>
</property>
<property>
<label>XA_QUADRANT</label>
<value>3:5</value>
</property>
<property>
<label>XA_REMINDER_REQUIRED</label>
<value>1</value>
</property>
<property>
<label>XA_REMINDER_DONE</label>
<value>0</value>
</property>
<property>
<label>A_AUTHORIZATION_COMPLETE_FLAG</label>
InterfaceAgreement
47
TelefonicaArgentina
<value>1</value>
</property>
<property>
<label>A_AUTHORIZATION_COMPLETE_USER</label>
<value>A</value>
</property>
<property>
<label>A_AUTHORIZATION_COMPLETE_TSTAMP</label>
<value>B</value>
</property>
<property>
<label>A_AUTHORIZATION_NOT_DONE_USER</label>
<value>C</value>
</property>
<property>
<label>A_AUTHORIZATION_NOT_DONE_TSTAMP</label>
<value>D</value>
</property>
<property>
<label>A_AUTHORIZATION_SUSPEND_FLAG</label>
<value>1</value>
</property>
<property>
<label>A_AUTHORIZATION_SUSPEND_USER</label>
<value>E</value>
</property>
<property>
<label>A_AUTHORIZATION_SUSPEND_TSTAMP</label>
<value>F</value>
</property>
<property>
<label>A_OVERRIDE_AUTHORIZATION</label>
<value>1</value>
</property>
<property>
<label>XA_CURRENT_DIAGNOSIS</label>
<value>SRREP001</value>
</property>
<property>
<label>XA_ADSL_DATA</label>
<value><![CDATA[
<XA_ADSL_DATA>
<DslamRack>A</DslamRack>
<DslamShelf>B</DslamShelf>
<DslamSlot>C</DslamSlot>
<DslamPort>D</DslamPort>
<BlockPots>E</BlockPots>
<PinPots>F</PinPots>
<BlockAdsl>G</BlockAdsl>
<PinAdsl>H</PinAdsl>
</XA_ADSL_DATA>
]]></value>
</property>
<property>
<label>XA_PREVENTIVE_DATA</label>
<value><![CDATA[
<XA_PREVENTIVE_DATA>
<NumeroBajadas>a</NumeroBajadas>
<NumeroCruzadas>b</NumeroCruzadas>
<NumeroModulos>c</NumeroModulos>
</XA_PREVENTIVE_DATA>
]]></value>
</property>
<property>
<label>XA_COPPER_DATA</label>
<value><![CDATA[
<XA_COPPER_DATA>
<ManzanaCaja>A</ManzanaCaja>
InterfaceAgreement
48
TelefonicaArgentina
<DomicilioCaja>B</DomicilioCaja>
<Caja>C</Caja>
<ParDesde>D</ParDesde>
<ParHasta>D</ParHasta>
<CablePrimario>E</CablePrimario>
<ParPrimario>F</ParPrimario>
<DomicilioArmario>G</DomicilioArmario>
<Armario>H</Armario>
<ParSecundario>I</ParSecundario>
</XA_COPPER_DATA>
]]></value>
</property>
<property>
<label>XA_MDF_DATA</label>
<value><![CDATA[
<XA_MDF_DATA>
<NumeroEquipoIP>C</NumeroEquipoIP>
<CoordenadaHorizontal>D</CoordenadaHorizontal>
</XA_MDF_DATA>
]]></value>
</property>
<property>
<label>XA_FO_DATA</label>
<value><![CDATA[
<XA_FO_DATA>
<FibraOptica>A</FibraOptica>
<LineaFibra>B</LineaFibra>
<TipoEmplazamiento>A</TipoEmplazamiento>
<CentralFibra>I</CentralFibra>
<CableFibra>I</CableFibra>
<Manzana>I</Manzana>
<Caja>I</Caja>
<TipoCaja>I</TipoCaja>
<Tramo1>I</Tramo1>
<Tramo2>I</Tramo2>
<Tramo3>I</Tramo3>
<HWVersion>I</HWVersion>
</XA_FO_DATA>
]]></value>
</property>
<property>
<label>XA_ISP_DATA</label>
<value>ISP</value>
</property>
<property>
<label>XA_PRODUCTS_SERVICES</label>
<value><![CDATA[
<XA_PRODUCTS_SERVICES>
<ProductService>
<Codigo>A1</Codigo>
</ProductService>
<ProductService>
<Codigo>A2</Codigo>
</ProductService>
</XA_PRODUCTS_SERVICES>
]]></value>
</property>
<property>
<label>XA_NOTE</label>
<value><![CDATA[
<XA_NOTE>
<Observacion>
<Fecha>A1</Fecha>
<Texto>C1</Texto>
</Observacion>
InterfaceAgreement
49
TelefonicaArgentina
<Observacion>
<Fecha>A2</Fecha
<Texto>C2</Texto>
</Observacion>
<Observacion>
<Fecha>A3</Fecha>
<Texto>C3</Texto>
</Observacion>
</XA_NOTE>
]]></value>
</property>
<property>
<label>XA_CURRENT_PRODUCTS_SERVICES</label>
<value><![CDATA[
<XA_CURRENT_PRODUCTS_SERVICES>
<ProductService>
<Codigo>A1</Codigo>
</ProductService>
<ProductService>
<Codigo>A2</Codigo>
</ProductService>
<ProductService>
<Codigo>A3</Codigo>
</ProductService>
</XA_CURRENT_PRODUCTS_SERVICES>
]]></value>
</property>
<property>
<label>XA_EQUIPMENT</label>
<value><![CDATA[
<XA_EQUIPMENT>
<Equipment>
</Equipment>
<Equipment>
</Equipment>
<Equipment>
</Equipment>
</XA_EQUIPMENT>
]]></value>
</property>
</properties>
<inventories>
<inventory>
<properties>
<property>
<label>invsn</label>
<value>SN34634987</value>
</property>
<property>
<label>quantity</label>
<value>2</value>
</property>
InterfaceAgreement
50
TelefonicaArgentina
<property>
<label>invpool</label>
<value>customer</value>
</property>
</properties>
</inventory>
<inventory>
<properties>
<property>
</property>
<property>
<label>quantity</label>
<value>6</value>
</property>
<property>
<label>invpool</label>
<value>customer</value>
</property>
</properties>
</inventory>
</inventories>
</appointment>
</command>
</commands>
</data>
</urn:inbound_interface_request>
</soapenv:Body>
</soapenv:Envelope>

A2.2.2 Activity Creation Response / Respuesta a la Creacin de Actividad

xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"xmlns:SOAPENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:si="http://soapinterop.org/xsd"xmlns:ns1="http://toatech.com/toasoap/1.0/"xmlns:tns="NameSpace">
<SOAPENV:Body>
<inbound_interface_responsexmlns="urn:toatech:InboundInterface:1.0">
<userxmlns="">
<now>20140820T16:50:370500</now>
<login>soap</login>
<auth_string>0119a8e1a248c23cfc640a6c9e9b4cdd</auth_string>
</user>
<headxmlns="">
<date/>
</head>
<dataxmlns="">
<commands>
<command>
<date>20140820</date>
InterfaceAgreement
51
TelefonicaArgentina
<type>update_appointment</type>
<external_id>BK_ACCESO_VERNET</external_id>
<appointment>
<name>FelipePoncet</name>
<customer_number>C638830890</customer_number>
<aid>848</aid>
<inventories>
<inventory>
<properties>
<property>
</property>
</properties>
<userdata/>
<invid>81</invid>
<report>
<message>
<result>success</result>
<type>update</type>
<code>0</code>
<description>Inventoryid=81</description>
</message>
</report>
</inventory>
<inventory>
<properties>
<property>
</property>
</properties>
<userdata/>
<invid>80</invid>
<report>
<message>
<type>update</type>
<code>0</code>
<description>Inventoryid=80</description>
</message>
</report>
</inventory>
</inventories>
<report>
<message>
<type>move</type>
<code>0</code>
<description>Appointmentid=848,fromqueueid=82toqueueid=83</description>
</message>
<message>
<type>update</type>
<code>0</code>
<description>Appointmentid=848</description>
</message>
</report>
</appointment>
</command>
</commands>
</data>
</inbound_interface_response>
</SOAPENV:Body>
</SOAPENV:Envelope>
InterfaceAgreement
52
TelefonicaArgentina
A2.3 Order Modify / Modificacin de Orden

A2.3.1 Order Modify Request / Solicitud de Modificacin de Orden
<soapenv:Header/>
<soapenv:Body>
<user>
<now>20131017T16:47:390500</now>
<login>soap</login>
<auth_string>ba91f0f325160bce26f0cb612fc86108</auth_string>
</user>
<head>
<appointment>
<keys>
<action_if_completed>update</action_if_completed>
</keys>
</appointment>
<inventory>
<keys>
</keys>
</inventory>
</head>
<data>
<commands>
<command>
<appointment>
<name>EjemploNombreCliente</name>
</appointment>
</command>
</commands>
</data>
</soapenv:Body>
</soapenv:Envelope>
A2.3.2 Order Modify Response / Respuesta de Modificacin de Orden

<SOAPENV:Body>
InterfaceAgreement
53
TelefonicaArgentina
<userxmlns="">
<now>20131017T16:47:390500</now>
<login>soap</login>
<auth_string>ba91f0f325160bce26f0cb612fc86108</auth_string>
</user>
<headxmlns="">
<date/>
</head>
<dataxmlns="">
<commands>
<command>
<type>update_appointment</type>
<appointment>
<name>EjemploNombreCliente</name>
<aid>134</aid>
<report>
<message>
<type>update</type>
<code>0</code>
</message>
</report>
</appointment>
</command>
</commands>
</data>
</SOAPENV:Body>
</SOAPENV:Envelope>
A2.3.3 Order Reschedule Request / Solicitud de Reagendamiento de Orden
<?xmlversion="1.0"encoding="UTF8"?>
<soapenv:Header/>
<soapenv:Body>
<user>
<now>20140820T16:59:160500</now>
<login>soap</login>
<auth_string>42976a6952e6ee315918285767731f5a</auth_string>
</user>
<head>
<appointment>
<keys>
</keys>
</appointment>
<inventory>
<keys>
</keys>
</inventory>
</head>
<data>
<commands>
<command>
<date>20140825</date>
InterfaceAgreement
54
TelefonicaArgentina
<appointment>
<properties>
<property>
<label>XA_PENDING_EXTERNAL_ACTION</label>
<value/>
</property>
</properties>
</appointment>
</command>
</commands>
</data>
</soapenv:Body>
</soapenv:Envelope>
A2.4 Work Order Cancel / Cancelacin de Orden de Trabajo

A2.4.1 Work Order Cancel Request / Solicitud de Cancelacin de Orden de Trabajo
<soapenv:Header/>
<soapenv:Body>
<user>
<now>20120719T07:27:470500</now>
<company>demo</company>
<login>soap1</login>
<auth_string>6f9c302de76a081e5e0284c8d7664086</auth_string>
</user>

<head>
<appointment>
<keys>
</keys>
</appointment>
<inventory>
<keys>
</keys>
</inventory>
</head>
<data>
<commands>
<command>
<type>cancel_activity</type>
<appointment>
</appointment>
</command>
</commands>
InterfaceAgreement
55
TelefonicaArgentina
</data>
</soapenv:Body>
</soapenv:Envelope>
A2.4.2 Work Order Cancel Response / Respuesta a la Cancelacin de Orden de Trabajo

<SOAPENV:Body>
<userxmlns="">
<now>20120719T07:23:100500</now>
<company>demo</company>
<login>soap1</login>
<auth_string>fcbd257a117a4ae78fabde1f511963f6</auth_string>
</user>
<headxmlns="">
<date/>
</head>
<dataxmlns="">
<commands>
<command>
<type>cancel_appointment</type>
<appointment>
<aid>4224070</aid>
<report>
<message>
<type>cancel</type>
<code>0</code>
</message>
</report>
</appointment>
</command>
</commands>
</data>
</SOAPENV:Body>
</SOAPENV:Envelope>
A2.5 Outbound Messages / Mensajes de Outbound

A2.5.1 Status Change / Cambio de Estado
<?xmlversion="1.0"encoding="UTF8"?>
<SOAPENV:Envelopexmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"xmlns:ns1="urn:toatech:agent">
<SOAPENV:Body>
InterfaceAgreement
56
TelefonicaArgentina
<ns1:send_messagexmlns="urn:toatech:agent">
<user>
<now>20130531T14:42:49+00:00</now>
<company></company>
<login>app_user</login>
<auth_string>XXXXXXXXXXXX</auth_string>
</user>
<messages>
<message>
<app_host>XXX.TOAdirect.com</app_host>
<app_port>55001</app_port>
<app_url>/outbound/</app_url>
<message_id>2006</message_id>
<company_id>2</company_id>
<address>external_system</address>
<send_to>2013060105:00:00</send_to>
<subject>ReadSubjectTable/LeertabladeSubject</subject>
<body>ReadBodyTable/LeertabladeBody</body>
</message>
</messages>
</ns1:send_message>
</SOAPENV:Body>
</SOAPENV:Envelope>
A2.5.2 Status Change Response / Respuesta de Outbound

xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"
xmlns:SOAPENC="http://schemas.xmlsoap.org/soap/encoding/"xmlns:si="http://soapinterop.org/xsd"
xmlns:ns1="http://toatech.com/toasoap/1.0/">
<SOAPENV:Body>
<ns1:send_message_response>
<message_response>
<message_id>2006</message_id>
<status>sent</status>
<description>...</description>
</message_response>
</ns1:send_message_response>
</SOAPENV:Body>
</SOAPENV:Envelope>
A2.6 Activity Messages / Mensajes de Activity

A2.6.1 Get Activities Request / Solicitud de Bsqueda de Actividades
InterfaceAgreement
57
TelefonicaArgentina
<?xmlversion="1.0"encoding="Windows1252"?>
<soapenv:Envelopexmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:urn="urn:toa:activity">
<soapenv:Header/>
<soapenv:Body>
<urn:get_activities>
<user>
<now>20140820T17:04:290500</now>
<login>soap</login>
<auth_string>669349c7b19f91286cb680dde19bc872</auth_string>
</user>
<resources>
<!1ormorerepetitions:>
<resource>
<resource_id>ARG</resource_id>
<include_children>all</include_children>
</resource>
</resources>
<date_range>
<date_from>20140821</date_from>
<date_to>20140918</date_to>
<include_unscheduled>true</include_unscheduled>
</date_range>
<select_count>1000</select_count>
<filter_expression>
<field>resource_id</field>
<operator>has_prefix</operator>
<value>BK_</value>
</filter_expression>
<required_properties>
<label>appt_number</label>
<label>status</label>
<label>resource_id</label>
<label>resource_id</label>
<label>end_time</label>
<label>A_COMPLETE_REASON_INSTALL</label>
<label>A_COMPLETE_SUBREASON_INSTALL</label>
<label>A_COMPLETE_REASON_QUALITY</label>
<label>A_COMPLETE_REASON_PREV</label>
<label>A_COMPLETE_SUBREASON_PREV</label>
<label>A_COMPLETE_REASON_SPLICE</label>
<label>A_COMPLETE_SUBREASON_SPLICE</label>
InterfaceAgreement
58
TelefonicaArgentina
<label>A_MAIN_COMPLETE_REASON_PRODUCT</label>
<label>A_COMPLETE_REASON_REP_FAM_STB</label>
<label>A_COMPLETE_REASON_REP_FAM_BA</label>
<label>A_COMPLETE_REASON_REP_FAM_TV</label>
<label>A_COMPLETE_REASON_REP_MINOR_BA</label>
<label>A_COMPLETE_REASON_REP_MINOR_STB</label>
<label>A_COMPLETE_REASON_REP_MINOR_TV</label>
</required_properties>
</urn:get_activities>
</soapenv:Body>
</soapenv:Envelope>
A2.6.2 Get Activities Response / Respuesta de Bsqueda de Actividades

<soapenv:Envelopexmlns:urn="urn:toa:activity"xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<urn:get_activities_response>
<result_code>0</result_code>
<expression>'resource_id'has_prefixBK_</expression>
<activities>
<activity>
<properties>
<name>appt_number</name>
</properties>
<properties>
<name>status</name>
<value>pending</value>
</properties>
<properties>
<name>resource_id</name>
<value>BK_ACCESO_VERNET</value>
</properties>
<properties>
<name>end_time</name>
<value>2014082502:03:00</value>
</properties>
<properties>
<name>A_COMPLETE_REASON_INSTALL</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_SUBREASON_INSTALL</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_QUALITY</name>
<value/>
</properties>
InterfaceAgreement
59
TelefonicaArgentina
<properties>
<name>A_COMPLETE_REASON_PREV</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_SUBREASON_PREV</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_SPLICE</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_SUBREASON_SPLICE</name>
<value/>
</properties>
<properties>
<name>A_MAIN_COMPLETE_REASON_PRODUCT</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_FAM_STB</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_FAM_BA</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_FAM_TV</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_MINOR_BA</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_MINOR_STB</name>
<value/>
</properties>
<properties>
<name>A_COMPLETE_REASON_REP_MINOR_TV</name>
<value/>
</properties>
</activity>
</activities>
<statistics>Querytime:0.0093
Processingtime:0.0004
Resultsreturned:1
InterfaceAgreement
60
TelefonicaArgentina
Propertiesperresult:19
Responsesize:0.002MB
Peakmemory:1.750MB
Queuesize:1
Queuewaittime:0</statistics>
</urn:get_activities_response>
</soapenv:Body>
</soapenv:Envelope>
InterfaceAgreement
61
TelefonicaArgentina
A3. Linked Activities / Actividades Vinculadas
The SDK document specifies how to link

activities. Link types must be configured in
TOAdirect and for Telefonica the following link
types have been defined to use in the
<link_type>label.
El documento SDK especifica cmo vincular

actividades. Los tipos de vnculos deben estar
configuradas en TOAdirect y para Telefnica se
han definido los siguientes siguientes tipos para
usarenlaetiqueta<link_type>
LinkType
TipodeVnculo
preventivo
Description
Descripcin
AssignementConstraints
RestriccionesdeAsignacin
Thisactivityisapreventiveactivityrelated
toapreviouslycreatedactivity,whose
appt_numberisspecifiedinthelink.
Estaactividadesunaactividadde
preventivoqueserelacionaconlaactividad
previamentecreada,cuyoappt_numberse
especificaenelvnculo.
sobrestancia
Thisactivityisaqualityactivityrelatedtoa
previouslycreatedactivity,whose
appt_numberisspecifiedinthelink.
Estaactividadesunaactividadde
sobrestanciarelacionadaaotraactividad
previamentecreada,cuyoappt_nu,berse
especificaenelvnculo.
Bothactivitieswillstartsequantially,
firstthespecifiedactivityandright
afterthepreventiveactivity.Both
activitieswillbeassignedtothe
sameresource.
Lasdosactividadescomenzarn
secuencialmente,primerola
actividadespecificadayluegola
actividaddepreventivo.Ambas
actividadesseasignarnalmismo
recurso.
Therearenotanyspecial
assignmentconstraints.
Nohayrestriccionesespecialesde
asignacin.
InterfaceAgreement
62

TEF AR - Interface Agreement Phase 1 v2.0

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

TEF AR - Interface Agreement Phase 1 v2.0

Caricato da

Copyright:

Formati disponibili

TelefonicaArgentina

SRS Appendix - Interface Agreement

Apndice del SRS - Acuerdo de

TOA TECHNOLOGIES, INC

TOA TECHNOLOGIES, INC

TOA TECHNOLOGIES, INC

TOA TECHNOLOGIES, INC

This document presents the Interface Agreement

Este documento presenta el Acuerdo de uso de

TOA TECHNOLOGIES, INC

Related Documents / Documentos Relacionados

La siguiente seccin contiene referencias usadas

TOA TECHNOLOGIES, INC

2. TOAdirect Interfaces / Interfaces de TOAdirect

TOA TECHNOLOGIES, INC

Connection parameters/ Parmetros de Conexin

Inbound API / API Inbound

Outbound API / API Outbound

URL para respuestas asncronas

URL para respuestas asncronas

TOA TECHNOLOGIES, INC

Capacity API / API Capacity

ActivityV2 API / API ActivityV2

TOA TECHNOLOGIES, INC

API LOAD / Carga de la API

Outbound API / API Outbound

TOA TECHNOLOGIES, INC

Capacity API / API Capacity

ActivityV2 API / API ActivityV2

TOA TECHNOLOGIES, INC

TOA TECHNOLOGIES, INC

Overview of Interfaces/ Resumen de Interfaces

The following interactions have been identified during

TOAdirect SDK documentation defines the security,

La documentacin de SDK de TOAdirect define la

TOA TECHNOLOGIES, INC

order to detail the technical specification of the

Interfaces ser preparado por TOA para detallarlas

Losarchivos dedata warehousesegenerarntodas

TOA TECHNOLOGIES, INC

3. Capacity Management Interfaces / Interfaces de Gestin de

Query the Capacity Categories from TOAdirect in

Permite consultar las categoras de capacidad

Capacity query returns the bucket in which the

INT_CAPACITY es un interfaz de tipo SOAP

Request Structure / Estructura de la Peticin

Las peticiones delcomando get_capacity incluirn

Response Structure / Estructura de la Respuesta

TOA TECHNOLOGIES, INC

which is necessary to create

cuota y capacidad disponible en

NOTA: consultar anexo A1.2 para conocer los

TOA TECHNOLOGIES, INC

4. Inbound Interfaces / Interfaces Inbound

The behavior andcore xml structure oftheincoming

La interfaz de Creacin de Ordenes de Trabajo

Request Structure / Estructura de la Peticin

TOA TECHNOLOGIES, INC

Response Structure / Estructura de la Respuesta

TOA TECHNOLOGIES, INC

4.2 Modify Work Order / Modificar Orden de Trabajo

NOTE: work order reschedule is achieved also

The behavior and core xml structure of the

Request Structure / Estructura de la Peticin