Boletas on DTEM

Recursos

Thu, 29 Apr 2021 11:02:05 +0600

Recursos

Los siguientes recursos de API están disponibles en el contexto del Boleta:

Resource	Available endpoints
Dtes	dtem/emision/Boleta/:tipo
Emite	dtem/emision/Boleta/:tipo/:folio/Emite
Status	dtem/emision/Boleta/:tipo/:folio/Status
Referencia	dtem/emision/Boleta/:tipo/:folio/referencia
Detalle	dtem/emision/Boleta/:tipo/:folio/Detalle
Pdf	dtem/emision/Boleta/:tipo/:folio/Pdf
Pdf417	dtem/emision/Boleta/:tipo/:folio/Pdf417

Dte

Wed, 19 Dec 2018 11:02:05 +0600

DTE

Atributos de una Boleta

Crea una Boleta y Obtiene los atributos de un documento

Crea un nuevo Documento

Create un DTE dado el Tipo

POST dtem/emision/Boleta/:tipo/

curl --request POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <your_access_token>" \
--data <JSON con datos del DTE> \
"https://erp.csc-chile.com/dtem/emision/Boleta/41"

ej Boleta

{
  "Encabezado": {
    "IdDoc": {
      "FchEmis": "2021-10-30",
      "IndServicio": 3,
      "PeriodoDesde": "2021-10-01",
      "PeriodoHasta": "2021-10-30",
      "FchVenc": "2021-10-30"
    },
    "Receptor": {
      "RUTRecep": "77777777-7",
      "RznSocRecep": "EMPRESA DE PRUEBA",
      "DirRecep": "AV. PROVIDENCIA",
      "CmnaRecep": "PROVIDENCIA",
      "CiudadRecep": "SANTIAGO"
    },
    "Totales": {
      "MntExe": 222,
      "MntTotal": 222,
      "VlrPagar": 222
    }
  }
  "Detalle": [
    {
      "NroLinDet": 1,
      "NmbItem": "Nombre 2",
      "DscItem": "descrip 2",
      "QtyItem": 2.0,
      "PrcItem": 222.0,
      "MontoItem": 111
    }
  ]
}

Crea un nuevo Documento

Create un DTE dado el Tipo y Folio explícito

Emite

Fri, 28 May 2021 11:02:05 +0600

Emite un DTE

Con este end point se gatilla la generación del XML, su firma Electrónica, y envío al SII. Se retorna un JSON de Status del DTE.

GET dtem/emision/Documento/:tipo/:folio/Emite

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta del Documento
folio	integer	yes	El Folio del DTE o ruta del Documento

ej de Respuesta

{
  "Estado": "2",
  "Glosa": "Enviado al SII",
  "TimestampFirma": "2021-05-27 17:09:26",
  "TrackId": "",
  "Encabezado": {
    "IdDoc": {
      "TipoDTE": 33,
      "Folio": 1083,
      "FchEmis": "2021-05-27",
      "FmaPago": 2,
      "MedioPago": "EF"
    }
  }
}

Status

Fri, 28 May 2021 11:02:05 +0600

Status un DTE

Con este end point se obtiene el estado de un DTE Se retorna un JSON de Status del DTE.

GET dtem/emision/Documento/:tipo/:folio/Status

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta del Documento
folio	integer	yes	El Folio del DTE o ruta del Documento

ej de Respuesta

{
  "Estado": "15",
  "Glosa": "Enviado a e-Customer",
  "TimestampFirma": "2021-05-27 17:09:26",
  "TrackId": "",
  "Encabezado": {
    "IdDoc": {
      "TipoDTE": 33,
      "Folio": 1083,
      "FchEmis": "2021-05-27",
      "FmaPago": 2,
      "MedioPago": "EF"
    }
  }
}

Emisor

Wed, 19 Dec 2018 11:02:05 +0600

Emisor DTE

Atributos del Emisor

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta de la Boleta
folio	integer	yes	El Folio del DTE o ruta de la Boleta
RUTEmisor	String	yes	RUT del Emisor (pattern [0-9]+-([0-9]
RznSocEmisor	String	yes	Nombre o Razon Social del Emisor
GiroEmis	String	yes	Giro Comercial del Emisor Relevante para el DTE
CdgSIISucur	String	No	Codigo de Sucursal Entregado por el SII
DirOrigen	String	No	Direccion de Origen
CmnaOrigen	String	No	Comuna de Origen
CiudadOrigen	String	No	Ciudad de Origen

Los datos requeridos se tienen almacenados en la configuración de cada contribuyente, por lo que no es necesario ingresarlos, ya que seran llenados en la creación inicial del documento con dichos valores por defecto. Si se requiere modificar alguno de los datos por defecto se debe enviar en la creación del DTE ó hacer un PUT.

Lista datos del Emisor de un Documento

Obtiene los datos del Emisor asociados a un documento

Receptor

Wed, 19 Dec 2018 11:02:05 +0600

Receptor DTE

Atributos del Receptor

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta de la Boleta
folio	integer	yes	El Folio del DTE o ruta de la Boleta
RUTRecep	String	yes	RUT del Receptor DTE (pattern [0-9]+-([0-9]
CdgIntRecep	String	No	Codigo Interno del Receptor
RznSocRecep	String	yes	Nombre o Razon Social del Receptor
Contacto	String	No	Telefono o E-mail de Contacto del Receptor
DirRecep	String	No	Direccion Receptor
CmnaRecep	String	No	Comuna de Recepcion
CiudadRecep	String	No	Ciudad de Recepcion
DirPostal	String	No	Direccion Postal
CmnaPostal	String	No	Comuna Postal
CiudadPostal	String	No	Ciudad Postal

Lista Datos Receptor de una Boleta

Obtiene Datos del Receptor asociadas a una Boleta

Detalle

Sat, 29 Dec 2018 11:02:05 +0600

Detalle API

Atributos de una Linea de Detalle

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta del Documento
folio	integer	yes	El Folio del DTE o ruta del Documento
NroLinDet	integer	yes	Numero secuencial de linea de detalle
CdgItem +	integer	No	(tipo, valor)5
IndExe	integer	No	1: indica item exento
NmbItem	String	yes	Nombre del item
DscItem	String	No	Descripción ampliada Item
QtyItem	integer	yes	Cantidad del Item
PrcItem	integer	yes	Precio unitario del Item
DescuentoPct	integer	No	Monto descuento en porcentaje
DescuentoMonto	integer	No	Monto deldescuento en valor
SubDscto +	integer	No	(tipo valor)5
RecargoPct	integer	No	Monto Recargo en Porcentaje
RecargoMonto	integer	No	Monto Recargo en Valor
SubRecargo +	integer	No	(tipo valor)5
MontoItem	integer	yes	Monto Total del Item

Lista las Lineas de Detalles de un Documento

Obtiene todas las lineas de detalles de un documento

Referencia

Sat, 29 Dec 2018 11:02:05 +0600

Referencia DTE

Atributos de una Linea de Referencia

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta del Documento
folio	integer	yes	El Folio del DTE o ruta del Documento
NroLinRef	integer	yes	Numero secuencial de linea de Referencia
TpoDocRef	String	yes	Tipo documento referencia segun codigo SII
FolioRef	Integer	yes	Folio documento de referencia
CodRef	Integer	No	Tipo Uso Referencia (1:Anula, 2:Corrige Monto, 3:Corrige Texto)
RazonRef	String	No	Razon por la que se Referencia el Documento
CodVndor	String	No	Código del Vendedor establecido por la Empresa. Puede estar asociado a INTERNET
CodCaja	String	No	Código de la caja establecido por la Empresa

Máximo de repeticiones 40 líneas.

Pdf417

Fri, 12 Mar 2021 20:00:19 -0300

Imagen Timbre (PDF417)

Obtención del Imagen Timbre (PDF417) de una Boleta

Obtiene pdf417 de un documento

GET dtem/emision/Boleta/:tipo/:folio/Pdf417

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta de la Boleta
folio	integer	yes	El Folio del DTE o ruta de la Boleta

curl –header “Authentication: Bearer <your_access_token>” “https://erp.csc-chile.com/dtem/emision/Boleta/39/1234/Pdf417"

Ejemplo de respuesta;

Archivo gif de respuesta

Pdf

Wed, 19 Dec 2018 11:02:05 +0600

Representación Impresa de un DTE (PDF)

Obtención del PDF de un Boleta

Obtiene pdf de un documento

GET dtem/emision/Boleta/:tipo/:folio/Pdf

Attribute	Type	Required	Description
tipo	integer	yes	El tipo del DTE o ruta de la Boleta
folio	integer	yes	El Folio del DTE o ruta de la Boleta

curl –header “Authentication: Bearer <your_access_token>” “https://erp.csc-chile.com/dtem/emision/Boleta/39/1234/Pdf"

Ejemplo de respuesta;

Archivo pdf de respuesta