1. Home
  2. SW API´S
  3. Efisco API Recepcion Metadatos ERP
  1. Home
  2. Efisco
  3. Efisco API Recepcion Metadatos ERP

Efisco API Recepcion Metadatos ERP

Servicio que permite la recepción de los metadatos de los CFDIs de los ERPs con los que se quiere conciliar con los metadatos del SAT, a través de la creación de una solicitud que publica un archivo .CSV con el layout de efisco para documentos de factura, complementos de pago y complementos de nómina.

🛠 Url Pruebas : https://api.test.sw.com.mx

🧰 Url Producción : https://api.sw.com.mx

Generar URL

Genera una URL pre-firmada en AWS S3 donde será publicado el archivo .CSV.

Endpoint

MétodoRuta
POST/efisco/v1/api/corpinputdata

Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

Parámetros JSON

PropiedadTipoUsoDescripción
taxIdstringRequeridoRFC.
typestringRequeridoTipo de descarga (“emitidos”, “recibidos”).
documentTypestringRequeridoTipo de documento (Cfdi: “0”, Nominas: “1”, Pagos: “2”).
namestringRequeridoNombre del archivo.

Ejemplo Request

curl --request POST \
  --url https://api.test.sw.com.mx/efisco/v1/api/corpinputdata \
  --header 'Authorization: bearer $token' \
  --header 'Content-Type: application/json' \
  --data '{
	"TaxId":"EKU9003173C9",
 	"Type":"emitidos", 
 	"DocumentType": "0",
 	"Name":"cfdi2022" 
}'

Ejemplo Response

Response Ok
{
    "data": {
        "url": "https://smarter-gestion-xml-s3-prod.s3.amazonaws.com/ERP/2022/8/30/emitidos/EKU9003173C9/1346b659-9cb2-42ec-be5d-777dc2c9c09f_cfdi2022.csv?AWSAccessKeyId=AKIAVRP5AMYOYVPEJ3XV&Expires=1662478879&Signature=V74gTC%2BtSIlmoDGgqGg4ojMbHhA%3D"
    },
    "status": "success",
    "message": "OK",
    "messageDetail": ""
}

Cargar CSV

Carga el archivo .CSV a un AWS S3 usando la URL obtenida en el paso anterior a través de un método PUT.
En este paso se debe verificar que efectivamente se haya cargado el archivo antes de continuar con el siguiente paso.

Endpoint

MétodoRuta
PUT{URL obtenida en el paso anterior.}

Autenticación y Headers

HeaderValue
Content-Typeapplication/octet-stream

Parámetros Body

PropiedadTipoUsoDescripción
databinaryRequeridoArchivo CSV.

Ejemplo Request

curl --request PUT \
  --url 'https://smarter-gestion-xml-s3-prod.s3.amazonaws.com/ERP/2022/8/30/emitidos/EKU9003173C9/1346b659-9cb2-42ec-be5d-777dc2c9c09f_cfdi2022.csv?AWSAccessKeyId=AAAAAAAAAAAAAAAAAAAA&Expires=1662478879&Signature=XXXxXX%0XxXXlxxXXxxXx4xxXxXxX%3X' \
  --header 'Content-Type: application/octet-stream' \
  --data DQo=

Ejemplo Response

Response Ok
{
    "data": {
        "requestID": "d6fdff8b-87a4-4bfc-8091-e2ea3702f153",
        "idDealer": "ce8ec187-73a6-49f1-b956-6521bf673edd",
        "idUser": "ce8ec187-73a6-49f1-b956-6521bf673edd",
        "idLicense": "ffbb665c-7673-4115-af5f-319cb1a0c4ec",
        "name": "cfdi2022",
        "type": "emitidos",
        "documentType": 0,
        "taxId": "EKU9003173C9",
        "urlFile": "https://smarter-gestion-xml-s3-prod.s3.amazonaws.com/ERP/2022/8/30/emitidos/EKU9003173C9/1346b659-9cb2-42ec-be5d-777dc2c9c09f_cfdi2022.csv?AWSAccessKeyId=AKIAVRP5AMYOYVPEJ3XV&Expires=1662481913&Signature=8zJbthAl1d%2FiGFLLtZK%2FJ0neiXw%3D",
        "dateRequested": "2022-08-30T11:31:53.0008463",
        "dateFrom": "2022-01-01T00:00:00",
        "dateTo": "2022-12-31T00:00:00",
        "totalRows": 8215,
        "origin": 1,
        "status": 5,
        "requestIdOrigin": null
    },
    "status": "success",
    "message": "OK",
    "messageDetail": ""
}

Guardar Metadatos

Guarda la solicitud de metadatos a procesar del ERP en efisco.

Endpoint

MétodoRuta
POST/efisco/v1/api/corpinputdata/upload

Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

Parámetros JSON

PropiedadTipoUsoDescripción
urlFilestringRequeridoURL prefirmada.
taxIdstringRequeridoRFC.
typestringRequerido Tipo de descarga (“emitidos”, “recibidos”).
documentTypestringRequerido Tipo de documento (Cfdi: “0”, Nominas: “1”, Pagos: “2”).
namestringRequeridoNombre del archivo.
dateFromstringRequeridoFecha de inicio (“dd/MM/yyyy”).
dateTostringRequeridoFecha final (“dd/MM/yyyy”).
totalRowsstringRequeridoTotal de registros.
origin intRequerido(Default: 1) Origen.

Ejemplo Request

curl --request POST \
  --url https://api.test.sw.com.mx/efisco/v1/api/corpinputdata/upload \
  --header 'Authorization: bearer $token' \
  --header 'Content-Type: application/json' \
  --data '{
  "urlFile": "https://smarter-gestion-xml-s3-prod.s3.amazonaws.com/ERP/2022/8/30/emitidos/EKU9003173C9/1346b659-9cb2-42ec-be5d-777dc2c9c09f_cfdi2022.csv?AWSAccessKeyId=AAAAAAAAAAAAAAAAAAAA&Expires=1662478879&Signature=XXXxXX%0XxXXlxxXXxxXx4xxXxXxX%3X",
  "TaxId": "EKU9003173C9",
  "Type": "emitidos",
  "DocumentType": "0",
  "Name": "cfdi2022",
  "DateFrom": "01/01/2022",
  "DateTo": "31/12/2022",
  "TotalRows": "8215",
  "Origin": 1
}'

Ejemplo Response

Response Ok
{
    "data": {
        "requestID": "d6fdff8b-87a4-4bfc-8091-e2ea3702f153",
        "idDealer": "ce8ec187-73a6-49f1-b956-6521bf673edd",
        "idUser": "ce8ec187-73a6-49f1-b956-6521bf673edd",
        "idLicense": "ffbb665c-7673-4115-af5f-319cb1a0c4ec",
        "name": "cfdi2022",
        "type": "emitidos",
        "documentType": 0,
        "taxId": "EKU9003173C9",
        "urlFile": "https://smarter-gestion-xml-s3-prod.s3.amazonaws.com/ERP/2022/8/30/emitidos/EKU9003173C9/1346b659-9cb2-42ec-be5d-777dc2c9c09f_cfdi2022.csv?AWSAccessKeyId=AKIAVRP5AMYOYVPEJ3XV&Expires=1662481913&Signature=8zJbthAl1d%2FiGFLLtZK%2FJ0neiXw%3D",
        "dateRequested": "2022-08-30T11:31:53.0008463",
        "dateFrom": "2022-01-01T00:00:00",
        "dateTo": "2022-12-31T00:00:00",
        "totalRows": 8215,
        "origin": 1,
        "status": 5,
        "requestIdOrigin": null
    },
    "status": "success",
    "message": "OK",
    "messageDetail": ""
}

En SW® somos mejores para TI, es por ello que tu opinión es muy importantepor favor ayúdanos calificando este articulo y dejando tus comentarios.

How useful was this post?

Click on a star to rate it!

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Updated on septiembre 8, 2023

Related Articles